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EDITOŘIAL 


Welcome to the first issue of RISC User, the magazíne for all users of the Archimedes, Acorďs 
new Computer systém based on RISC technology. RISC User aims to provide in-depth practical 
information essential to all Archimedes users, programs which will provide readers with 
substantial Utilities and applications for the new machine, as well as many demonstrations and 
examples of programming techniques. Reviews will also feature strongly, together with up-to- 
the-minute news on all Archimedes happenings. We háve well established links with Acorn 
personnel, but we are independent and will be critical of all suppliers where appropriate. We 
also aim to cater for all users from beginner to expert, with a range of articles in each issue. In 
that way your copies of RISC User will build into an indispensable source of information on your 
Archimedes, one that you can refer to time and time again. 




RISC User is not only a magazíne. We aim to provide the best all-round support for Archimedes 
users, based on over five years experience with the BBC micro and Master series through our 
magazíne and user group, BEEBUG. We offer you technical support by phone or by letter, all as 
part of your subscription, and discounts on what will be a growing range of new products for 
Archimedes, all in addition to a first rate magazíne. 

These are very early days for Archimedes, and we are all very much learning together how to 
derive the maximum benefit from this superb machine. We hope very much that you will write to 
us and telíš us what you like and dislike about RISC User. We will also be only too delighted if 
you wish to share your experiences of Archimedes with other readers, and contribute 
information, articles and programs for publication. That way we will all learn, and we pay for all 
materiál ušed. 

The Archimedes is a major achievement on the part of Acorn, and we certainly wish it every 
success. We shall be doing all we can to promote Archimedes and to help Archimedes users 
through RISC User. We hope you feel the same and will work with us in this endeavour. 

PROGRAM NOTES 

All the programs published in RISC User will be fully tested by our own staff, and listed out 
directly from working programs. However, the smaller memory on the A305, compared with the 
A310, will mean that the former systém may need to be re-configured to suit the needs of 
different programs. For A305 users we will indicate where necessary the minimum values of 
SCREENSIZE, SPRITESIZE or RMASIZE needed. If no value is given then the defaults on your 
systém will be adequate. 



Lee Calcraft, Mike Williams 
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The following report has been compiled to provide the 
latest Information on software and other products for 
Archimedes. Some products available now háve been 
reviewed in "Off The Shelf" in this issue. The information 
here is essentially news items on likely releases from 
various suppliers and software houses. 

Alt prices quoted below include VAT, and are followed 
by the expected release dáte. 


ACORN 

Without any warning, Acorn announced in September 
that there would be a reduction of £115 (inc. VAT) on all 
300 Series machines as from lOth October. Acorn has 
also announced the A310M, which incorporates the PC 
emulátor, at an extra £69 (inc. VAT) on top of the A310 
price. 

SOFTWARE APPLICATION CATALOGUE is now into 
its 3rd edition and is 72 pages long. We can supply this 
on receipt of an A5 SAE. 0% FINANCE. Acorn has set up 
a scheme whereby purchasers of full-price Archimedes 
310 systems may, for as little as 1/12th down-payment, 
pay the remainder over the following twelve months. 
Payments being interest free. The scheme will only 
operáte until 31 st December 1987 and is available 
through all registered Archimedes dealers (including 
BEEBUG). However, it will také 3-4 days to arrange. 
Phone us for details. 

£50 EDUCATIONAL VOUCHERS. Whenever an 
educational establishment buys an Archimedes it will 
receive a £50 voucher, which when sent to Acorn will be 
returned as a £50 cheque. 

I/O PODULES. Code: AKAI, £90.85. In stock NOW. 

ROM PODULE. Code: AKA0, £44.85. December. Acorn 
are still looking at what resident operational software to 
include. 

MIDI ADD-ON l/O PODULE. Code: AKAI5, £33.35. The 
User Guide is currently being printed, and it will be 
available in November. 

BACKPLANE. Code: AKA01, £44.85. The Backplane 
includes the fan, and is currently in stock. 
WINCHESTER. Code: AKD50, £573.85. December. 
Winchester upgrade includes backplane. 

2ND DISC DRIVE. Code: AKD5, £143.75. October. 
MONO SYSTEMS. Mono Monitor for use with the 
305/310 systems not available until November. "Entry" 
systems will run equally well with any other standard 
mono monitor. 


"MODEM". Hayes compatible modem podule especially 
for the Archimedes. Provides V21 & V23 baud rates as 
standard, with V22 & V22bis rates with tone dial. Full 
Hayes "AT" command set together with battery backed 
phone number and ’S' register store. Line monitoring 
through computer's speaker, V25 auto-answer and 
selectable bell toneš. Price T.B.A. Available December. 
COMMAND. Price T.B.A. (latě 1987 - early 1988). 
Communications software using WIMPS, featuring a 
range of terminals - Viewdata, VT52, VT100, Tektronix 
4010, Teletype etc. Supports range of modems, facility to 
customise modem drivers. Wide range of filé transfer 
protocols including XMODEM, YMODEM, KERMIT, CET. 
Features disc manager, phone directory, host mode. Self- 
contained comms language to control all its features 
MONITOR CONVERSION KIT. £40-£50. November. 
Enables the Archimedes to be connected to Microvitec 
and similar monitors. Will consist of a smáli interface box 
and leads. 

COMPUTER CONCEPTS 

INTERWORD, £44.85. INTERSHEET, £44.85. 
INTERCHART, £28.75. ALL THREE £97.75. (£17.25 
each to existing users). Emulátor only. ROM only. 
Available November. 

WORDWISE PLUS. An emulátor version is available now 
at £33.35. Existing users may exchange their ROM for 
£11.50 by quoting their WW+ seriál number. (Contact CC 
for details). 

INTERBASE. Not to be released for the Archimedes. 

DISC DOCTOR II. According to Computer Concepts this 
product is not feasible on the current operating systém. 
The anticipated availability is July 1988. 
"WORDPROCESSOR". Available early 1988. Anticipated 
to be less than £100. Written specifically for the 
Archimedes. This will be on ROM. Similar but better than 
MacAuthor, with WIMPS, WYSIWYG, Magnify/Reduce, 
Auto-lndent, Multi-document, Multi-windows, Fonts, 
incorporation of graphics, spelling checker at 60,000 
words per minuté (an improved Spellmaster), Thesaurus, 
Multi Printer Drivers including Laser. 

"DRAWING PACKAGE". Available on ROM in early 
1988. Anticipated to be less than £100. Links to their 
wordprocessor and future products, will be fast, WIMPS, 
will include textual definitions of drawings which may be 
altered to change the drawing. It includes its own 
programming language. 

8 ROM PODULE. Available November. This podule is 
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intended to be compatible with Acorrťs ROM board, but 
will be at a much lower price. 

CLARES 

ALPHA BASE. £49.95. End of October. Compatible with 
the Model B's Betabase, free formát input, window/icon 
driven, 400 fields, 27600 characters per record, range 
check, different access levels, passwords. Multiple pages/ 
screens per record. 

IMAGE WRITER. £29.95. Mid-October. A wordprocessor 
providing on-screen features reproducible on the Epson 
FX80, standard machine font, control window based, 
document (not page) based, graphics areas with graphics 
module. 

MINERVA SYSTEMS 

SYSTEM DELTA PLUS. £69.96. Early November. 
Relational Database Management System. WIMP 
database allows search selection from within Windows. 
Fully programmable using System Delta Commands. 
Programmer's Reference Guide available at extra £29.95. 
SUPER DELTA. £199.95. First half of 1988. 

REPORTÉR. £24.95. Early November. User definable 
reports, for use with Deltabase and System Delta Plus. 
SYSTEM SIGMA. Price T.B.A. November. Spreadsheet 
Management System. 

GAMMAPLOT. £34.95. November. General graphics 
program allowing the production of graphics and charts 
such as bar, pie, scatter, line and histogram. 

PERSONÁL ACCOUNTANT. November. Requires either 
System Delta, or System Delta Plus to run. Personál 
Accountant consists of the following individual packages: 
Order Processing, Sales Ledger, Purchase Ledger, 
Nominal Ledger, Stock Management. £64.95 each. 
SPECIALIST APPLICATIONS. Requires System Delta, 
or System Delta Plus to run. School Administrátor £79.95, 
Newsagent £69.95. Ancestry, Timetabling Prices T.B.A. 

BBC SOFT 

ARCCOMM. £24.95. January88. 

ARCWORD. Price T.B.A. No release dáte. This 
wordprocessor is to be aimed at the every-day, rather 
than the advanced user. 

BLACK QUEEN. Approx £15. November. Black Queen 
is a Contract Bridge program available for BBC/Master & 
Compact. The Compact version will work on the 
Archimedes. A specialist Archimedes version will be 
released in December. 


WATFORD ELECTRONICS 

REÁL TIME MONO DIGITISER. Approx £170. 
November. 

SERIÁL KIT. £28.75. Available NOW. The kit enables the 
Archimedes to be linked with a BBC Model B or Master 
Computer. 5.25" 

Notě that Acorn has said that the use of a connecting 
cable to an external 5.25" disc drive will invalidate the 
guarantee, and may well damage your Archimedes. 
DATABASE SOFTWARE. Price T.B.A. Mid November. 
PAINT PACKAGE. Price T.B.A. Latě November. This 
package is Icon-driven and (according to Watford 
Electronics) is far superior to the Quest paint package. 

ACORNSOFT 

VIEW, VIEWSHEET, VIEWSTORE, VIEWINDEX. 

Separate versions are available now that run under the 
emulátor. 

VIEW PROFESSIONAL. £113.85. Spring 1988. The full 
Archimedes version contains many extra features, and 
will possibly be re-named. 

LISP, £113.85. PROLOG, £113.85. LOGISTIX, £113.85. 
All available now. 

TERMULATOR. Available December. 

LOGOTRON LTD 

ARCHIMEDES LOGO. £69. December 1987 Developed 
jointly with Acorn, this product is fully compatible with 
Logo for the Master and BBC computers. The INSTALL 
primitive allows Logo to be extended with specialised 
applications modules for example: 

CONTROL LOGO. £17.25. Early 1988. Lets you explore 
Computer control applications by talking to all the ports, as 
well as most interfaces and controllers. 

MUSIC LOGO. £17.25. Early 1988. Takés full advantage 
of the Archimedes powerful sound potential, enabling you 
to use familiar musical notation. 

3D LOGO. £17.25. Early 1988 
SOFT SPRITES. Price T.B.A. Mid 1988 

AMS 

FINESSE PAINT. Price T.B.A. Dec 1987. Finesse Paint is 
an art program based around a graphics tablet 
environment. It will develop into an integrated systém 
including 3D CAD, Business Graphics, Maths Graphics 
and others. 
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SOLIDISK 

4 MEGABYTE BOARD. Price T.B.A. The hardware is 
ready now, however, the complete product including 
software will not be available until the release of the new 
version of the operating systém. 

UNILAB 

WEATHER SATELLITE RECEIVER & DISPLAY. Price 
T.B.A. December 1987. Enables you to receive signals 
from the NOAA weather satellite and use the Computer as 
a very sophisticated display terminál. 

TECHSOFT 

DESIGNÉR. Approx £270. February 1988. CAD package 
for schools, colleges, smáli businesses. Priced similarly to 
the BBC/Master version which has been well received. 

ARMADILLO 

AUDIO SAMPLER PODULE. Mid November 1987. 
Requires the Backplane. The board contains all the 
electronics to convert an audio signál into a digital one. 
An on-board EPROM contains the controlling software, 
the remainder is provided on floppy disc. Real-time 
display of voltage versus time; Spectal Analysis, Fast 
Fourier Transforms, Utterance detection, Dump to the 
VIDC sound chip. 

IAN COPESTAKE 

ARCHITYPE. Price T.B.A. Early 1988 WYSIWYG 
wordprocessor capable of displaying and printing texts in 
a variety of linguistic and scientific character sets. 

MEADOW COMPUTERS 

MICRO-TRADER. Approx £200. Fully integrated package 
including sales, purchase and nominal ledger. Integrates 
with Micro-Aid Extended Payroll. Pre-release version 
available early November, finál version January 1988. 
Purchasers of the pre-release version will be able to able 
to upgrade in January. 

MICRO-STOCK. Approx £75. Stock control package 
available as add-on or stand-alone. 

MICRO-MAILER. Approx £30. Works with Wordwise or 
View. PÍ 


WH AT IT DOES 

The accompanying picture should give a 
j: reasonable idea of what the menu module 
offers. It will display all the contents of your 
;j current directory, with filenames in black and 
; directory names in white, for easy identification. 

As you move the mouše over the various 
ji filenames the bottom line of the screen gives 
filé details of the item currently under the 
pointer. You use two clicks of the selecí button 
i (far left button) either to select a new directory, 
or to load and run a Basic program. 

All filé types other than Basic will be 
executed just as if you had entered: 

*filename 

from the keyboard. Thus machine code will be 
loaded and run, modules will be installed, and 
so on. If on the other hand you double-click the 
adjust button (far right), the filé will be simply 
loaded into memory. 

Double clicking with any of the three mouše 
iji buttons on any of the upper boxes of the 
display will háve the expected effect. QUIT will 
také you back to the environment which you 
were in when the menu was called (i.e. Basic, 
or Arthur, or whatever). Dir A will také you up 
the directory hierarchy by one level, and 
MOUNT will mount a new disc. You can also 
use the latter to také you to the root directory of 
your current disc. Additionally, stár commands 
can be entered directly from the keyboard. 


305 USERS 

This program will run on an otherwise default- 
configured 305 providing that the RMA size is 
configuredto 10 or more. 


INSTALLING THE MODULE 

Type the program in very carefully, and 
savé it away to disc before running it. When 
you run the program, it will assemble the 
machine code module, then automatically savé 
it away to disc under the filename RMENU, and 
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ARCHIMEDES DISC MENU 

By David Pilling 



This piece of ARM code automatically 
installs itself as a relocatable module to 
give you mouše control of the Arc s disc 
environment. Move around the directories, 
load and run Basic programs, or load files 
into your word processor all at the click of 
the mouše. 

then install the module. To call the menu, just 
type: 

*MENU 

at any time. To leave the menu, either use the 
QUIT box, or press Escape. 

The module will stay in plače until you 
press Ctrl-Break, or the machine is turned off, 
and may even be called from within another 
application. To re-install it at any time, just type: 

*RMENU 

If it is not in your current directory, you will 
need to give the full path name (tor example 
TMODULES.RMENU). 

I hope that you will find this menu so useful 
that you will want to automatically load it up 
from a IBOOT tile every time that you switch 
your machine on. If so, watch this space, 
because next month we will be incorporating 
some extra facilities, like deleting marked files, 
etc. We will also put to use a speciál option for 
loading files into word processors and the like. 
This is already incorporated in the program, 
and is activated by double-clicking with the 


middle button. And for those with tired fingers, 
there is a working copy of the menu program 
on this montIVs magazíne disc. 

10 REM >MenuP 

20 REM Program Disc Menu Module 

30 REM Version A 1. OP 

40 REM Author David Pilling 

50 REM Risc User November 1987 

60 REM Program Subject to Copyright 

70: 

80 DIM code &2000:PROCsetup 
90 FOR pass= 0 TO 2 STEP 2 
100 P%=code:[ OPT pass 
110 EQUD0:EQUD0:EQUD0:EQUD0 
120 EQUD help-code 
130 EQUD help-code 
140 EQUD comm-code 
150.help 

160 EQUS n Disc-Menu":EQUB0 
170.comm 

180 EQUS"MENU":EQUB0:ALIGN 
190 EQUD go-code:EQUD0:EQUD0 
200 EQUD helpt-code:EQUB0 
210.helpt 

220 EQUS"Use *MENU to engage the " 

230 EQUS"disc menu":EQUB13 
240 EQUS"Syntax: *MENU":EQUB0 
250 EQUS STRING$(128,CHR$0) 

260.stack 
270.poir 

280 EQUS"POINTER 1":EQUB13 
290.go 

300 STMFD R13!,{R0-R12,R14} 

310 TEQP R15,#0:ADR R8,stack 
320.go2 

330 SWI ws:EQUB22:EQUB14:EQUB0 

340 ADR R0,poir:SWI cli 

350.newd:BL set 

360 MOV Rl,#4:MOV R9,#100 

370.newl:BL moun:SUBS R1,R1,#1 

380 BGE newl:BL bloo:SWI wr+31 

390 SWI wr+3:SWI wr+7:SWI ws 

400 EQUS"Dir:":EQUB0:ADR R2,blok 

410 MOV R0,#6:BL plib:SWI wr+31 

420 SWI wr+33:SWI wr+7:SWI ws 

430 EQUS"Lib:":EQUB0:ADR R2,blok 

440 MOV R0,#7:BL plib 

450 BL getf:MOV R12,#77 

460.mlpl:BL poin:LDRB R2,[Rl,#&14]! 

470 CMP R2,#0:BNE mlp2 
480 SUBS R12,R12,#1:BGE mlpl 
490.mlp2:ADD R11,R12,#1 
500 MOV R12,#0:B loopx 
510.loop:BL tabn:BL poin 
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520 LDRB R3,[Rl, #&10]:CMP R3,#2 
530 BLEQ grog:BLNE blog:BL prif 
540 ADD R12,R12,#1 
550.loopx:CMP R12,R11:BNE loop 
560.mloop:SWI es:BCS quit 
570 MOV R0,#1:STRB R0,rtcb 
580 ADR Rl,rtcb:MOV R0,#14:SWI wo 
590 LDRB R0/rtcb+6:CMP R10,R0 
600 MOV R10,R0:BLNE bloo:BLNE ptime 
610 SWI ms:BL maps:BEQ mloopO 
620 CMP R0,#&28:BLT mloopO 
630 SUB R0,R0,#&28:CMP R0,R11 
640 BGE mloopO:CMP RO,R9:MOV R9,R0 
650 BEQ mloopO:MOV R12,R0:BL poin 
660 BL bloo:SWI wr+31:SWI wr+0 
670 SWI wr+24 

680 SWI ws :EQUS" ":EQUB0:BL prif 

690 SWI ws:EQUS" Load:":EQUB0 

700 LDR R0,[Rl],#4:BL hex 

710 SWI ws:EQUS" Exec:":EQUB0 

720 LDR R0,[R1],#4:BL hex 

730 SWI ws:EQUS" Length:":EQUB0 

740 LDR R0,[R1],#4:BL hex 

750.mloopO:MOV RO,#145:MOV R1,#0 

760 SWI by:BCS mloopl 

770 CMP R2,#ASC"*":BNE mloopl 

780 SWI ws:EQUB31:EQUB3:EQUB6 

790 EQU S"*":EQUB2 3:EQUB1:EQUB1:EQUB 0 

800 SWI wr : SWI wr:SWI wr:SWI wr:SWI wr 

810 SWI wr:SWI wr:ADR R0,blok 

820 MOV Rl,#77:MOV R2,#32:MOV R3,#128 

830 SWI rs:BCS ex:SWI wr+22:SWI wr+14 

840 ADR R0, blok:SWI cli:SWI ws 

850 EQUS"Press any key":EQUB0:SWI rd 

860.ex:MOV R0 / #&7C:SWI by:B go2 

870.blok:EQUS STRING$(80,CHR$0) 

880.mloopl 

890 SWI ms:ANDS R2,R2,#7:BEQ mloop 
900.mloop2:SWI ms:ANDS R2,R2,#7 
910 BNE mloop2:MOV R0,#1:ADR Rl,time 
920 SWI wo:LDR R4,time 
930.mloop3:MOV R0,#1:ADR Rl,time 
940 SWI wo:LDR R0,time:SUB R0,R0,R4 
950 CMP R0,#35:BGT msing:SWI ms 
960 ANDS R2,R2,#7:BEQ mloop3:MOV R4,R2 
970.mloop4 

980 SWI ms:ANDS R2,R2,#7:BNE mloop4 
990 SWI ms:BL maps:BEQ mloop 
1000 CMP R0,#&28:BLT topco 
1010 SUB R0,R0,#&28:CMP R0,R11 
1020 BGE mloop:MOV R12,R0:BL poin 
1030 LDRB R3,[Rl,#&10]:CMP R3,#2 
1040 BEQ isdir:BL quits 
1050 CMP R4,#1:BEQ load 
1060 CMP R4,#2:BEQ menu 
1070 LDR R0, [R1]:BIC R0,R0,#&FF 


1080 MOV R3,#0:SUB R3,R3,#&500 
1090 CMP R3,R0:BNE runc 
1100 ADR R0,runbn:BL mbsb 
1110 ADR R0,runb:SWI cli 
1120.runc 

1130 ADR R0,runn:BL mbsb 
1140 ADR R0,run:SWI cli:B quit2 
1150.run:EQUS"RUN " 

1160.runn:EQUS STRING$(12,CHR$0) 

1170.runb:EQUS"BASIC -CHAIN " 

1180.runbn:EQUS STRING$(12,CHR$ 0) 

1190.menu 

1200 ADR R0,setn:BL mbsb 
1210 ADR R0,setm:SWI cli 
1220 ADR R0,exme:SWI cli:B quit2 
12 3 0.exme:EQUS"!MENU*":EQUB13 
1240.setm:EQUS"SET FNAME " 

1250.setn:EQUS STRING$(12,CHR$0) 

1260.load 

1270 ADR R0,lodn:BL mbsb 
1280 ADR R0,lod:SWI cli:B quit2 
1290.lod:EQUS"LOAD " 

1300.lodn:EQUS STRING$(12,CHR$0) 

1310.isdir 

1320 ADR R0,dirn:BL mbsb 
1330 ADR R0,dir:SWI cli:B newd 
1340.mbsb:ADD R1,R1,#&14 
1350.mbsl:LDRB R2,[R1],#1:CMP R2,#0 
1360 MOVEQ R2,#13:STRB R2,[R0],#1 
1370 BNE mbsl:MOV R15,R14 
1380.dirb:EQUS"DIR A ":EQUB13 
1390.dir:EQUS"DIR " 

1400.dirn:EQUS STRING$(12,CHR$0) 

1410.topco 

1420 CMP R0,#&1D:BEQ quit 
1430 CMP R0,#&19:BEQ back:SUBS R0,R0,#5 
1440 BLT mloop:CMP R0,#5:BLT mountn 
1450 REM more commands go here ******* 
1460 B mloop 

1470.plib:SWI gb:LDRB R3,[R2,#1]! 

1480.libí:LDRB R0,[R2,#1]!:SWI wc 
1490 SUBS R3,R3,#1:BNE libl:MOV R15,R14 
1500.ptime 

1510 SWI wr+31:SWI wr+53:SWI wr+0 

1520 MOV R0,#0:STRB R0,rtcb:ADR Rl,rtcb 

1530 MOV R0,#14:SWI wo 

1540 ADR Rl,rtcb:MOV R2,#0 

1550.ptlp:LDRB R0,[Rl],#1:SWI wc 

1560 ADD R2,R2,#1:CMP R2,#24:BNE ptlp 

1570 MOV R15,R14 

1580.rtcb:EQUS STRING$(25,CHR$0) 

1590.mountn 

1600 ADD R0,R0,#ASC"0":STRB R0,mouts 
1610 ADR R0,mout:SWI cli:B newd 
1620.mout:EQUS"MOU." 

1630.mouts:EQUB32:EQUB13 
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1640 .moun:ADD R0,R1,R1, ASL#2 

1650 ADD R0,R0,R0,ASL#1:ADD R0,R0,#3 

1660 SWI wr+31:SWI wc:SWI wr+1 

1670 SWI ws:EQUS" MOUNT ":EQUB0 

1680 ADD R0,Rl,#ASC"0":SWI wc 

1690 SWI ws:EQUS" ":EQUB0:MOV R15,R14 

1700.back 

1710 ADR R0,dirb 

1720 SWI cli:B newd 

1730.msing 

1740 REM insert single click code here 
1750 B mloop 
1760.quit 

1770 MOV R0,#&7C:SWI by:BL quits 
1780.quit2:SWI os 
1790 LDMFD R13!,{R0-R12,R15} A 
1800.quits:STMFD R8!,{R0-R7,R14} 

1810 SWI ws:EQUB22:EQUB12:EQUB0 
1820 MOV RO,#&6A:MOV R1,#0:MOV R2,#0 
1830 SWI by:LDMFD R8!,{R0-R7,R15} 

1840.time 

1850 EQUD 0:EQUB 0 
1860.maps 

1870 RSB R1,R1,#1024:MOV R0,R0,ASR#4 

1880 CMP R0,#3:BLT mapb 

1890 CMP R0,#76:BGT mapb 

1900 MOV R2,#0:SUB R0,R0,#2 

1910.mapl 

1920 MOV R3,R0:SUBS R0,R0,#15 
1930 ADDGE R2,R2,#1:BGE mapl 
1940 CMP R3, #0:BEQ mapb:MOV R0,#0 
1950.map2:SUBS R1,R1,#40:ADDGT R0,R0,#1 
1960 BGT map2:ADD R0,R0,R0,ASL#2 
1970 ADD R0,R0,R2:ORRS R1,R1,#1 
1980 MOV R15,R14 
1990.mapb 

2000 SUBS Rl,Rl,Rl:MOV R15,R14 
2010.hex 

2020 STMFD R8!,{R0-R7,R14} 

2030 MOV R3,#8:MOV R1,R0 
2040.hexO 

2050 MOV R1,R1,R0R#28 
2060 AND R0,R1,#15:CMP R0,#10 
2070 ADDGE R0,R0,#ASC n A n -10 
2080 ADDLT R0,R0,#ASC n 0":SWI wc 
2090 SUBS R3/R3/#1:BNE hexO 
2100 LDMFD R8!,{R0-R7,R15} 

2110.tabn 

2120 SWI wr+31:MOV RO,R12:MOV R2,#0 
2130.tabl:ADD R2,R2,#l:MOV R1,R0 
2140 SUBS R0/R0,#5:BGE tabl:MOV R3,#15 
2150 MUL R0 f R1/R3:ADD R0 f R0,#3:SWI wc 
2160 ADD R0,R2,#7:SWI wc:MOV R15,R14 
2170.prif 

2180 ADD R3 / R1 / #&14 

2190.prif2:LDRB R2 f [R3],#1:CMP R2,#0 


2200 MOV R0,R2:SWINE wc:BNE prif2 
2210 SUB R3,R3,R1:RSB R3,R3,#&21 
2220.prif3:SUBS R3,R3,#1:SWIGT wr+32 
2230 BGT prif3:LDRB R3,[R1,#&C] 

2240 LDRB R2,[Rl,#&10] 

2250 CMP R2,#2:BNE nodd 

2260 SWI ws:EQUS" D":EQUB0:BEQ noss 

2270.nodd 

2280 TST R3,#l:SWINE wr+ASC"R" 

2290 SWIEQ wr+32:TST R3,#2 
2300 SWINE wr+ASCW": SWIEQ wr+32 
2310.noss 

2320 TST R3,#8:SWINE wr+ASC"L" 

2330 SWIEQ wr+32 :MOV R15,R14 

2340.poin:ADR Rl,buff:MOV R0,R12 

2350.poil:SUBS R0,R0 f #1:MOVMI R15,R14 

2360 ADD R1,R1,#&14 

2370.poil2:LDRB R2,[Rl],#1:CMP R2,#0 

2380 BNE poil2:SUB R1,R1,#1 

2390 BIC R1,R1,#3:ADD Rl f Rl f #4:B poil 

2400.getf 

2410 ADR R0,buff:MOV Rl,#&F00:MOV R2,#0 
2420.mlpO:STR R2,[R0,R1]:SUBS R1,R1,#4 
2430 BPL mlpO:MOV R0,#10:ADR Rl,null 
2440 ADR R2,buff:MOV R3,#77:MOV R4,#0 
2450 MOV R5,#&1000:MOV R6,#0:SWI gb 
2460 MOV R15/R14 
2470.null:EQUB0 
2480.bloo 

2490 SWI ws:EQUB17:EQUB128+10:EQUB17 
2500 EQUB0:SWI wr+0:MOV R15 f R14 
2510.blog 

2520 SWI wr+17:SWI wr+0:SWI wr+17 
2530 SWI wr+128+8:MOV R15,R14 
2540.grog 

2550 SWI wr+17:SWI wr+ll:SWI wr+17 
2560 SWI wr+128+8:MOV R15,R14 
2570.set:ADR Rl,sets 
2580.seti 

2590 LDRB R0,[Rl] f #1:CMP R0,#ASC”$" 

2600 SWINE wc:BNE seti:MOV R15,R14 
2610.sets 

2620 EQUB19:EQUB0:EQUB24:EQUB64:EQUB80 
2630 EQUB112 

2640 EQUB19:EQUB8:EQUB16:EQUB128 
2650 EQUB144:EQUB176 
2660 EQUB19:EQUB9:EQUB16:EQUB0:EQUB48 
2670 EQUB180 

2680 EQUB19:EQUB10:EQUB16:EQUB0:EQUB24 0 
2690 EQUB240 

2700 EQUB19:EQUB11:EQUB16:EQUB224 
2710 EQUB224:EQUB240:EQUB17 
2720 EQUB128+9:EQUB12:EQUB17:EQUB128+10 
2730 EQUB17:EQUB0:EQUB31:EQUB0:EQUB24 

continued on page 26 
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ARCHIES WHITE MOUŠE 


ln the first oř our series on graphics, Lee Calcrařt shows how to make the 
Archimedes mouše perform to order. 

| A305 | 5C - | SP - | BMA 10 <x mofej 


The Archimedes mouše is a neatly 
constructed little rodent which software 
packages like the desktop, the painting 
program and the music editor on the Welcome 
disc háve exploited to the full. Fortunately, 
Acorn háve provided a simple set of commands 
which may be ušed from Basic to manipulate 
the mouše in any way that the user wishes. 
However, as with most other aspects of the A 
series machines, documentation is minimal, 
and the purpose of this article is to také you 
through some of the commands, and to 
develop a simple mouse-driven application. 

POINTER ON 

ln most cases when the mouše is in use, its 
position is indicated by an on-screen pointer, 
and this must be specifically enabled in order to 
make it visible. To do this, type: 

*POINTER 

You should now see the familiar blue pointer 
appear on screen; and moving the mouše 
around should cause the pointer to move. Once 
the pointer has been enabled, the mouše and 
pointer systém can be turned on and off with 
the two commands: 

MOUŠE ON 

and mouše off 

You will also see that changing screen mode 
clears the pointer (reinstate it with MOUŠE 
ON), but that executing: 

CLS 

or CLG 

to clear the current screen leaves the pointer 
unaffected. 

COLOURING THE POINTER 

Although the standard pointer comes in 
two-tone blue, a speciál command is provided 
to alter its colour. This has the syntax: 

MOUŠE COLOUR n,16*r,16*g,16*b 
where n is the so-called logical colour of the 
part to be re-coloured. ln practice n=1 refers to 
the outline of the default pointer, and n=2 the 
inside colour. The three remaining parameters 


MOUŠE COMMANDS COVERED 

‘POINTER 
MOUŠE ON 
MOUŠE OFF 
MOUŠE COLOUR 
MOUŠE RECTANGLE 
MOUŠE TO 
MOUŠE 


r, g, and b are the red, green and blue 
components of the new colour; and each must 
be supplied with a sixteen times multiplier, as 
implied in the definition above. The amount of 
each component r, g, and b can range from 0 to 
15 in integer steps. Thus: 

MOUŠE COLOUR 1,0,240,0 
will set the outline of the pointer to bright green 
(i.e. full green, with no red or blue), the 240 
being derived from 16*15. If you try: 

MOUŠE COLOUR 2,176,176,176 
this will set the inside of the pointer to a 
delicate shade of grey. If you do not like the 
colour combination that you háve set at any 
time, you can just execute: 

*POINTER 

to reset the colours to Acorn’s choice. 

RESTRAINING THE POINTER 

As you can see from experiment, the 
pointer can be made to travel anywhere within 
the main screen area. But you can if you wish 
restrict it to any chosen rectangle within that 
area. There are many reasons why you might 
wish to do this. For example, in a drawing 
package, you may want to restrict the pointer to 
the main drawing area, and so on. Again there 
is a simple command from Basic to achieve 
this. Contrary to information given in some 
versions of the User Guide, it takés the form: 

MOUŠE RECTANGLE x,y,width,height 
where x and y are the co-ordinates of the 
bottom left hand corner of the rectangle, 
measured in graphics units; and width and 
height are simply the width and height of the 
rectangle, again in graphics units. 
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ARCHIES WHITE MOUŠE 


The graphics units referred to are those 
ušed in all graphics modes of the Archimedes, 
and go from 0 to 1279 along the x (or 
horizontál) axis, and from 0 to 1023 along the y 
(or vertical) axis. The origin, or 0,0 point, is at 
the bottom left of the screen. To test this out, 
try the following: 

MOUŠE REC. 400,400,300,300 

You should find that the pointer is now confined 
to a smáli rectangle at the centre of the screen. 
Notice also the use of the abbreviation of the 


keyword. 


1023 


y 

axis 


is t 



-width ^ 



MOUŠE 

t 


RECTANGLE 

height 

1 

x,y 

i 

l 

1 - 

▼ 


1279 


Figuře 1. 

Definition of MOUŠE RECTANGLE. 


DIRECTING THE POINTER 

In a similar way you can send the pointer to 
any part of the screen - providing that it is not 
outside the area defined with MOUŠE 
RECTANGLE. The command: 

MOUŠE TO x,y 

will move the pointer to the position x,y, where 
x and y are again given in graphics units, and 
can range from 0 to 1279, and 0 to 1023 
respectively. Try: 

MOUŠE TO 0,0 

This should cause the pointer to move to the 
origin at the bottom left of the screen. 


RETURNING DATA 

So far we háve only looked at how to do 
things to the pointer: to colour it, move it 
around, and so on. The most useful bit is still to 
come. There is a simple command to get data 
back from the pointer. This informs us not only 
of where on the screen the pointer currently 
resides, but also what buttons, if any, are being 


pressed. Clearly this is all vital information, and 
it is fortunately very easily gathered. The 
command: 

MOUŠE x,y,b 

does it all. Each time that this function is 
executed, it returns the values of the x co- 
ordinate, the y co-ordinate, and the button 
pressed status in the variables x, y and b 
respectively. To see how this works, try the 
simple program which appears in listing 1. 

Listing 1 

10 REM >mousetest2 

20 REM Mouše test 
30 MODE 8 
40 OFF 

50 VDU19,0,24,0,240,240 
60 CIRCLE 640,512,10 
70 *POINTER 
80 REPEAT 
90 MOUŠE x,y,b 

100 PRINT TAB(30,5) ”X= ,, ;x;SPC4 
110 PRINT TAB(30,6)"Y= n ;y;SPC4 
120 PRINT TAB (30,7) ,, b=";b;SPC4 
130 UNTIL FALŠE 

When you run this program you should see 
a cyan-bordered screen with a smáli circle at 
the centre, and three numbers printed on the 
screen. These are the two co-ordinates of the 
mouše, its grid reference if you like, plus the 
result returned by the button status. You should 
find that the top two numbers, the x and y co- 
ordinates of the pointer position, change as you 

move the 
mouše 
around. 
When you 
move it to the 
left, the top 
number, the x 
co-ordinate 
will decrease, 
and as you 
move it to the 
right, it will increase towards the maximum 
value of 1279. The second figuře, the y co- 
ordinate, decreases as the pointer is moved 
downwards, and increases to a maximum of 
1023 as it is moved upwards. The smáli circle 
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ARCHIE'S WHITE MOUŠE 


in the centre of the screen should correspond 
to co-ordinates 640, 512. 

Now see what happens if you press a 
button. The button value, formerly zero, 
increases. If you press the left hand button, the 
selecí button, the number 4 should appear, the 
middle or menu button produces a 2, while the 
right hand button, the adjust button, produces a 
1. You will also see that if you press different 
buttons in combination, the numerical result will 
be the sum of the individual buttons pressed. 
To exit the program, just press Escape. 

As you can see from the listing, the program 
is reasonably straightforward. Line 30 sets the 
screen to mode 8 (a high resolution graphics 
mode which is reasonably economical on 
memory), then line 40 switches off the flashing 
cursor. Line 50 sets up the border colour, to 
delimit the screen area. For more details on this 
command, see this month's hints. Line 60 
draws a smáli circle at the centre of the screen, 
and the following line initialises the pointer. We 
now come to the main loop of the program. 
This is a REPEAT-UNTIL loop which 
continuously reads the mouše data (line 90), 
and displays the results. 


BUTTON 

VALUES RETURNED 

- - - 

0 - M A 3 

-A 

1 S - A 5 

- M - 

2 S M - 6 

s - - 

4 S M A 7 

S=Select 

(Left button) 

M=Menu 

(Middle button) 

A=Adjust 

(Right button) 


Figuře 1 


MOUŠE SKETCH PAD 

Armed with this basic information we can 
write a simple drawing program based around 
the mouše. The completed program is given in 
listing 2. It is relatively short, but performs well 
enough for simple sketching and doodling. If 
you type it in and run it, you will see a cyan 
border, with the painting area taking up the rest 


of the screen. The Controls are quite simple, as 
may be seen from figuře 2. With a little practice 
you will find that they are quite easy to use. 


SKETCH PAD CONTROLS 

s- 

Fine Line 

- M - 

Medium Line 

-A 

Thick Line 

S M - 

Eraser 

- M A 

Clear Screen 

S - A 

Load or Savé Screen 

S M A 

Exit 

S=Select 

(Left button) 

M=Menu 

(Middle button) 

A=Adjust 

(Right button) 


Figuře 2 


The only option which is not šelf 
explanatory is the load/save option invoked by 
pressing the select and adjust buttons 
simultaneously. This sets the screen border to 
red, and then waits for a key from the keyboard 
to be pressed. If S is pressed, the current 
screen will be saved away. If L is pressed, a 
screen is loaded from disc, while if any other 
key is pressed, the border is returned to cyan, 
and the sketching mode resumed. The 
filename ušed for both savé and load 
operations is always screen, and you should be 
warned that even though we háve ušed the 
proprietary commands, saving and loading také 
a very long time. Also, since no speciál error 
trapping has been included in the program, if a 
disc error occurs, the program will end, though 
without clearing the screen. Finally, the 
program may be exited by pressing all three 
mouše buttons simultaneously. To do this, you 
should start by pressing the middle button, to 
avoid calling the load/save option by mistake. 

HOW IT WORKS 

Let us také a look at how the program 
works. Lines 80 to 100 will be familiar from 
listing 1. But inside the REPEAT loop at line 
120 there is now a so-called CASE statement. 
This is situated between lineš 150 and 220, 
where the keyword ENDCASE indicates the 
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exit point. The čase statement is ušed to 
perform a number of different actions 
depending on the statě of the variable b. That is 
the effect of line 150: 

CASE b OF 

Line 160 handles what happens if b=4, line 170 
if b=2, and so on. 

When b=4 this means that the selecí button 
has been pressed. In response to this we draw 
a point at the pointer's own co-ordinates. This is 
performed by: 

POINT x,y 

This will draw a fine line if the button is held 
down, and the mouše moved. To draw a thicker 
line, we use a filled circle with a very smáli 
rádius. This is accomplished in line 170 in 
response to b=2 - the pressing of the middle 
mouše button. A circle with a larger rádius is 
ušed in line 180 to draw the thick lineš. 



Line 190 implements the eraser by 
switching the foreground drawing colour to 
black, with GCOL 0, and drawing thick lineš. 
Line 200, as you can see, implements a screen 
clear when the two rightmost buttons are 
pressed. The proceduře PROCdelay, defined at 
line 270, is ušed by both the eraser and the 
clear screen options. Its purpose is to ensure 
that no extra blobs get drawn after clearing or 
erasing, once the mouše buttons are released. 
Finally, line 210 implements the load and savé 
option, calling the proceduře PROCIoadsave at 
line 320. 


As you can see, the main part of the 
program between lineš 80 and 250 is extremely 
short. This illustrates, I hope, just how easy it is 
to create quite effective programs based 
around the mouše. You may care to write 
something along similar lineš, or to extend the 
Sketch Pad given here into a full-feature paint 
program, where painting and colour functions 
are selected by moving to specific boxes 
placed at the border of the screen. This of 
course opens up an infinity of options, rather 
than being limited to the number of different 
combinations of the three mouše buttons. 

Listíng 2 

10 REM >Sketch5 

20 REM Program Mouše Sketch Pad 
30 REM Version A 0.5 
40 REM Author Lee Calcraft 
50 REM Risc User November 1987 
60 REM Program Subject to Copyright 
70 : 

80 MODE 8:OFF 
90 VDU19,0,24,0,240,240 
100 *POINTER 
110 a=0 
120 REPEAT 
130 MOUŠE x,y,b 

140 IF b<>6 AND a=6 THEN PROCdelay 
150 CASE b OF 
160 WHEN 4:POINT x,y 
170 WHEN 2:CIRCLE FILL x,y,5 
180 WHEN 1:CIRCLE FILL x,y,20 
190 WHEN 6:GCOL 0:CIRCLE FILL x,y,20:G 
COL 7 

200 WHEN 3:CLS:PROCdelay 

210 WHEN 5:PROCIoadsave 

220 ENDCASE 

230 a=b 

240 UNTIL b=7 

250 ON:END 

260 : 

270 DEFPROCdelay 

280 TIME=0:REPEAT UNTIL TIME>50 

290 MOUŠE x, y,b 

300 ENDPROC 

310 : 

320 DEFPROCloadsave 

330 VDU19,0,24,240,0,0:*FX15 

340 A=GET:CASE A OF 

350 WHEN 83:OSCLI("SCREENSAVE screen") 
360 WHEN 76:OSCLI("SCREENLOAD screen") 
370 ENDCASE:VDU19,0,24,0,240,240 
380 ENDPROC gtl 
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With the Archimedes' superb graphics capability it is hardly surprising that Acorn should 
include a painting program on the Welcome disc, and Clares has quickly followed suit 
with its Artisan. How good are these two packages, and is it worth spending nearly £40 on 
the latter when the former is supplied free with the Archimedes? 

Mike Williams helps you make up your mind. 


One might háve expected that Acorn would 
háve dreamt up a more imaginative name for the 
painting package supplied on the Welcome disc. 
After all, the speed and colours of Archimedes do 
háve enormous potential for graphics. 
Notwithstanding, the Paint package does provide a 
most workmanlike approach, offering many of the 
facilities that one might expect. Don't be put off 
either by the unexciting screen layout; the facilities 
are there and they are easy to use. 

Welcome Paint 

If you háve an Archimedes no doubt you háve 
taken a look at what Paint has to offer. However, 
there are some less obvious features you may háve 
missed, and we'll review the main features for those 
who do not yet háve an Archimedes, or haven't tried 
this program. 

Paint makes little use of Windows and icons. 
Instead, various options are displayed to the left 
and right of the main drawing area, and are 
selected with the mouše. To the left of the screen 
the current set of colours is displayed, 16 in all, 
together with four patterns. The mouše may be 
ušed to select any colour or pattern as the current 
drawing colour. What is not readily apparent is, that 
by pointing at the word Colour at the head of this 
colour menu, will superimpose on the drawing area 
a colour mixer allowing any one of the Archimedes 
available colours to be included among the 16 on 
the screen. However, changing any colour in this 
way will also change any example of this colour 
already on the drawing area. 

The Controls for the colour mixer are a circle 
and a bar. Moving a rádius around the circle 
Controls the basic choice of colour with further 
variations achieved by changing the length of the 
rádius. Moving the bar slider up and down appears 
to darken or lighten the selected hue. The approach 
is a bit weird, and very much inferior to the colour 
palette control that is part of the desktop. This 
method of colour mixing is also incorporated in 
Artisan, and looks like setting the standard for this 
facility on the Archimedes. 


There is also a mode box which performs two 
functions. From a sub-display, you can select solid 
or outline shapes (called fill or open), and the mode 
of plotting (XOR, OR, AND or INV). As with other 
sub-menus, clicking on the diagonál cross symbol 
at the top of the window is the only way of removing 
it from the screen, unlike Artisan where menus 
automatically disappear once the mouše pointer 
moves away from them. 

The bottom edge of the screen displays the 
main functions of Paint. Selecting any of these will 
similarly display an appropriate sub-menu along the 
bottom of the screen. When you háve finished using 
a particular function, clicking on the function name 
in the bottom left-hand corner will return you to the 
main function menu, again not an obvious step. 



DRAWING AND PAINTING 

The draw function is likely to be the most ušed, 
and this provides 5 variations (line, joined, radii, 
brush, select). Line and joined both provide rubber- 
band style drawing, the former as separate lineš 
(click at start and end), and the latter joined lineš as 
the name implies. The last two options are 
concerned more with brush painting, allowing 
various shapes and sizes of brush to be selected. 
The sizing is not very extensive, and surprisingly no 
round brushes are provided, only triangular, 
rectangular and similar. In addition, I found the 
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brush and select options, and the select sub-menu 
somewhat cumbersome in use. 



SHAPES AND CURVES 

The shapes and curve functions can clearly be 
grouped together. These provide a range of straight 
line and curved shapes, either outline or filled 
depending on the current mode selected. All the 
shapes, as you might expect on an Archimedes, are 
drawn very swiftly indeed. There is also a text 
option which allows text, but in one height and style 
only, to be positioned on the screen. 

AREA 

The area function is one of the most useful, and 
some of the options within this function can produce 
quite fascinating results. There is a very fast flood 
fill which works from the current pointer position. A 
clear screen function may also be selected. This 
appears to do nothing till you move to the main 
drawing area and click the mouše - the screen 
immediately clears with no further warning! 

The Copy and Move options are much more 
interesting. In both cases a rectangle is defined to 
enclose part of the screen drawing area. This can 
then be moved or copied to any other location on 
the screen. The Copy function in particular, 
especially if the mouše is moved around with the 
button pressed, can produced most interesting 
displays very quickly indeed. This is a feature that is 
well worth exploring, but similar and much more 
extensive facilities are provided by Artisan. Lastly 
there is a function to allow you to define your own 
patterns on a pixel by pixel basis. 


LOAD AND SAVÉ 

These provide the facility to savé and load screen 
displays. There is no apparent way of using stár 
commands from within the Paint package, so saving 
and loading must be on the same disc as the Paint 
package. The omission of this facility by Acorn does 
seem a bit remiss. 

Artisan 

Clares, £39.95 inc VAT 

Artisan is a new painting and drawing program 
for the Archimedes from Clares, and perhaps 
derives something of its ancestry from Artist, 
produced by Clares for Acorn's Compact, and 
bundled in the Italian version of the same machine 
sold by Olivetti in Italy. 

Artisan is a highly superior product providing full 
colour graphics capability through some extremely 
well designed and colourful menus. These are very 
classy, with a three-dimensional look to them, and 
superb examples of what can be achieved with an 
Archimedes. We háve not yet seen the finál version 
of this product, but the pre-release version certainly 
impresses. 



Four main menus are implemented at present. 
One of these Controls such aspects as choice of 
brush, colour selection, flood fill, colour mixing and 
pattern defining. This menu also provides a three 
level zoom facility (two, four or eight times 
magnification), allowing individual pixels to be 
changed. Colour mixing and pattern definition, for 
example, lead into further sub-menus. As a 
comparison with Welcome Paint, Artisan provides a 
rounded brush whose size may be varied 
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continuously throughout the available range of 
sizes. Furthermore, there is a facility to define your 
own brush shape leading to all manner of effects 
(striped paint for example). 

The mouše buttons are ušed to the full, with the 
left-hand button selecting from menu options, while 
the middle button calls up the current menu on the 
screen, and the right-hand button is ušed in specific 
functions, such as zooming in and out. 



A second menu provides a variety of filled and 
outline shapes, and the opportunity to define your 
own shape. As with the others, the user-defined 
shape can be positioned and manipulated on 
screen to achieve the desired size and orientation. 
Separate and linked lineš using rubber banding are 
readily drawn, and both this menu and the previous 
one include their own colour selection functions. 

A further menu screen provides for the saving 
and loading of screens, and Clares has provided 
four superb examples to inspire and motivate. It is 
also possible to savé and load patterns and sprites, 
although the latter feature was not implemented in 
our early review copy. The finál menu is in many 
ways the most interesting, and provides some 
fascinating variations on the block copy and move 
idea. Any part of a picture can be copied or moved, 
and enlarged, reduced, rotated or flipped (to give a 
mirror image) at the same time. Several speciál 
effects are included, such as the magie pen, which 
allows one or more specified colours only to be 
changed by moving the magie pen across the 
screen. Such features are difficult to deseribe in a 
few words, but following the instructions in the 


accompanying manual soon begins to bring home 
the enormous potential of Clares' Artisan. 

CONCLUSIONS 

The Welcome Paint package provides most of 
the functions one might expect of a basic drawing 
package, and performs a workmanlike if uninspiring 
job. More imaginative use of Windows and icons, of 
which Archimedes is fully capable, would háve doně 
much to lift Paint above the merely ordinary. A 
zoom feature to allow pictures to be manipulated at 
the pixel level is really essential for any serious use, 
while the opportunity to display text in different 
styles, sizes and angles would háve helped as well. 
Lastly, one or two examples of what might be 
achieved with the Paint package would háve doně 
much to motivate the budding artist. However, Paint 
doesn't cost you a penny (once you háve bought an 
Archimedes), so if you just want to play about it will 
probably do fine. 

Although both Paint and Artisan háve many 
features in common, including the use of mode 12 
and its limitation of 16 colours, Artisan is much 
slicker and a lot more fun to use. The automatic 
deletion of menus in Artisan as soon as the pointer 
moves away does také some getting ušed to, but 
will be seen as an advantage as one's skill 
develops. I was very impressed with almost 
everything I tried with Artisan, and the manual 
(provisional version only so far) clearly explained all 
the many features with examples based on the five 
pictures included on the disc. If Computer art is to 
be fun then go and buy this package now - you 
won't be disappointed. We can only wait in eager 
anticipation for the finál version. 

Clares Micro Supplles, 98 Middlewich Road, Rudeheath, 
Northwlch, Cheshire CW9 7DA. 


RISC USER PAINTING COMPETITION 

Send us on disc your best artistic efforts, achieved 
with the Welcome Paint program, and we will award 
a prize of Clares' Artisan to the one we judge to be 
the best. Send your entries to: 

RISC User Painting Competitlon, 

Dolphin Plače, Holywell Hill, St Albans, 
Herts AL1 1EX. 

All dises will be returned where postage is included. 
Closing dáte 5 December 1987. 
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By David Graham 


A brief foray into the Archimedes Sound commands, 
including details on how to load new Instruments. 


BASIC SOUND June 1987 edition) gives the correspondence 


The fastest way to get sounds out of the 
- Archimedes is to use VDU7 or to press the Ctrl 
key at the same time as the "G" key. This 
produces a single standard beep. To get 
anything more you need to use the SOUND 
command. In its simple form, this works just like 
the earlier BBC B and Master computers. Four 
parameters are ušed to give the sound 
channel, the volume, the pitch and duration 
respectively. Forexample, try: 

SOUND 1,-15,200,20 
or for something lower in pitch: 

SOUND 1,-15,100,20 
or quieter: 

SOUND 1,-8,100,20 

This may look a bit involved if you are not ušed 
to the BBC micro, but it is fairly straightforward. 



The Sound Command 

Syntax: 

SOUND,Channel,Volume,Notě,Duration 

Parameter 

Range 

Channel 

1 to 8 

Volume 

-15 to 0 

Pitch 

0 to 255 

Duration 

0 to 255 (in twentieths) 


Figuře 1 


Let us také a closer look at the four 
parameters in turn. The first, the channel 
number, can také values from 1 to 8, but only 
channel 1 is normally present at switch-on. This 
' contrasts with the model B which has only 4 
channels, but all are active at power-up. The 
volume parameter takés the range -15 to 0, 
with zero producing no sound, and -15, 
maximum. The pitch parameter should be in 
the range 0 to 255, with high values producing 
highest pitch. The User Guide (page 150 in the 

v 

Ir 


between the pitch parameter and the actual 
notě played. 

Finally the fourth parameter determines the 
duration of the sound produced, and is given in 
units of twentieths of a second. In our example 
we ušed a value of 20, and so produced a notě 
of one seconďs duration. Integer values 
between 0 and 255 may be ušed. When 255 is 
ušed it is said to turn the sound channel on 
indefinitely (i.e. until Escape is pressed); 
though in practice the effective duration of the 
sound will not exceed the natural decay of the 
particular voice which is in use. It may now be 
worth experimenting with the volume, pitch and 
duration parameters for a bit before proceeding 
further. 

LOADING NEW VOICES 

As I said, the Archimedes has only one 
sound channel active on power-up. But it is 
possible to configure up to eight channels for 
simultaneous use. Each sound channel can be 
allocated to one so-called voice. To see what 
voices are available on your machine, and how 
they are allocated, just type: 

*VOICES 

This will cause a Channel Allocation Map to be 
displayed. It will probably look like that shown 
in figuře 2. This shows that only a single voice 
is present called WaveSynth-Beep , and that it 
has been allocated to channel 1. That is why 
we háve restricted ourselves to channel 1 so 
far. 


Channel Allocation Map 
before loadlng voices 

Voice Name 
1 1 WaveSynth-Beep 

aaaaaaaa Qhannel Allocation Map 


Figuře 2 


RISC User November 1987 


17 












Fortunately the Welcome disc contains 
some new voices. To load these in, first quit 
Basic using: 

QUIT 

Then, at the asterisk prompt, type: 

RMLOAD $.MODULES.stringlib 

and 

RMLOAD $.MODULES.percussion 

and get back into Basic with: 

BASIC 

If you now check the allocation map using: 

*VOICES 

you should see a display similar to that in figuře 
3. There are now 9 resident voices, though just 
as before, only voice 1 is allocated (again to 
channel 1). 


Channel Allocation Map 

after loading voices 

Voice 

Name 

1 1 

WaveSynth-Beep 

2 

StringLib-Soft 

3 

StringLib-Pluck 

4 

StringLib-Steel 

5 

StringLib-Hard 

6 

Percussion-Soft 

7 

Percussion-Medium 

8 

Percussion-Snare 

9 

Percussion-Noise 

aaaaaaaa Qh anne | Allocation Map 


Figuře 3 


To allocate some of the others, proceed as 
follows: 

*CHANNELVOICE 2 4 

*CHANNELVOICE 3 8 

This sets channel 2 to the "Steel" string voice 
(voice 4), and channel 3 to the "Snare" drum 
(voice 8). Type *VOICES to see the new 
allocation. 

Before we can make use of these new 
voices, we must telí the systém how many 
voices we want to make active. To enable the 


new voices, type: 

voices 3 

This last operation is easily forgotten. It is 
doubly confusing because it has the same 
name as that ušed to display the allocation 
map. But this time it is not a stár command it is 
part of ARM Basic - i.e. we must use VOICES 
rather than *VOICES. In fact the sound systém 
allocates voices in pairs, and VOICES 3 has 
the same effect as executing VOICES 4. 


Loading in New Voices 

QUIT (temporarily leave Basic) 

RMLOAD $. MODU LES.stringlib 
RMLOAD $.MODULES.percussion 
BASIC (get back into Basic) 

*CHANNELVOICE 2 4 (allocate voices) 
‘CHANNELVOICE 3 8 ditto 
‘CHANNELVOICE .. (allocate more 

. as required) 

VOICES 3 (up to 8, as applicable) 


Figuře 4 

Now we are ready to test out some of the 
new sounds. Try a few variations: 

SOUND 2,-15,100,30 

SOUND 3,-15,1,10 

You can also allocate more channels to some 
of the other voices, and test out the result. You 
will find, somewhat disappointingly, that the 
pitch parameter has no effect on any of the 
percussion sounds (though at least duration 
does), so you might as well set the pitch to 1 
each time. You may also find the repertoire of 
voices a little disappointing. In fact all the 
voices supplied were generated mathema- 
tically, rather than from sampling reál 
instruments. Fortunately though, at least one 
supplier is producing a sound sampler for the 
Archimedes. This will be able to create sound 
libraries directly from reál sounds, and should 
result in much more realistic and interesting 
effects. gjj 
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If you are a newcomer to using Acorn s ADFS disc systém, then this introductory article 

should help to get you started. 


The Archimedes 305 and 310 computers 
both incorporate a single 3.5 inch floppy disc 
drive. All operations using this drive are 
handled by a reasonably sophisticated disc 
systém called the Advanced Disc Filing 
System, or ADFS for short. This article is about 
using the ADFS. 

If you háve not ušed a disc systém before, 
then there is a good deal to get to grips with, 
and you are recommended to také a look at 
section 9 of the User Guide, which provides 
useful introductory information. In particular, 
you will need to be familiar with the idea of disc 
directories, and the hierarchical way in which 
they are organised. But let us start with disc 
files themselves. All data stored on disc, 
whether it be a Basic program, a block of text 
or a screen dump, is held as individual files. 
These files are themselves organised into 
groups called directories, each of which can 
accommodate up to 47 or 77 files depending 
on the disc formát in use. 

FORMATTING 

Before a disc can be ušed for the first time 
it must be formatted. This process lays down 
magnetic tracks on which programs and other 
data may later be stored. As the User Guide 
explains, the Archimedes can provide two 
alternativě formats; one capable of storing up 
to 640 kilo bytes of data (=655360 bytes) and 
allowing up to 47 objects per directory, or a so- 
called double density mode capable of storing 
up to 800 Kilo bytes of data (=819200 bytes) 
with up to 77 objects per directory. In fact the 
latter option has both greater capacity, and 
greater speed than the former, which is merely 
retained for compatibility with the ADFS on the 
old BBC micro (including Master and 
Compact). The formatting commands are: 

*FORMAT 0 L 
Or *FORMÁT 0 D 

The zero specifies the disc drive number, and 
the following letter supplies the formát size 


required. D indicates the double or extra large 
mode. When you háve issued this command, 
you will be asked to confirm your intention. This 
is because formatting a disc destroys 
everything which it previously held. 

Whichever disc formát you are using on the 
Archimedes, it is essential to employ high 
quality double sided discs. These should háve 
been approved for use at 135 TPI (or tracks per 
inch). In all cases, it is possible to use discs of 
a lower rating or quality, but by doing so you 
will considerably increase the chances of disc 
failure, and the consequent loss of programs 
and data. 

SAVING FILES 

After formatting a disc, the Archimedes will 
automatically verify it to check that it has 
formatted correctly, and will report accordingly. 
If all is well, you are now ready to savé some 
files. For the purposes of experiment you could 
create a one line program as follows: 

10 PRINT "A dummy program" 

To savé it, type: 

SAVÉ "name" 

where name is any name of up to 10 
characters in length. For the saké of argument 
we will call it "Progl". 

If you now type: 

*CAT 

this will display a catalogue of the disc, which 
should look something like that in figuře 1. The 
program filé Progl is shown to be present, and 
you will see that its name is followed by two 
letters WR. These indicate that the filé is 
enabled for both read and write operations - in 
other words it is not locked. You should now be 
able to run the program directly from disc by 
typing: 

CHAIN "Progl" 

Retuming to the catalogue display, také a look 
at the $ sign at the left of the screen. This is the 
name of the directory currently in use. 
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USING DISCS 


$ 

Disc 

11_2 4_Mon : 0 

Option 00 (Off) 

URD 1 

"Unset" 

Dir. "Unset" 

Lib. 

"Unset" 

Progl WR 




Figuře 1. Catalogue display 


DIRECTORIES 

When you formát a disc, it is provided with 
just one directory, the so-called root directory. 
This is indicated by the $ sign. It is then up to 
the user to create further directories as he 
wishes. One of the main advantages of doing 
this is that it allows you to organise your 
various programs and data in a sensible 
manner. For example, you might wish to use 
one directory for all correspondence, one for 
graphics programs, one for Utilities, one for 
business applications, and so on. If you 
generate a lot of correspondence, you may 
wish to use a separate correspondence 
directory for each month of the year. The 
systém is completely flexible, and it is entirely 
up to you how you organise things. 


So how do you create a new directory? Just 
use the command: 

*CDIR name 

where name is the name of the new directory. 
As with filenames, directories may be of up to 
10 characters in length. As an experiment, try: 

*CDIR TESTDIREC 
If you now catalogue your disc with: 

*cat (or * . forshort) 

you should see something like that shown in 
figuře 2. The new directory appears alongside 
the filé that we created earlier, but it differs 
from it in having the letters DL after it. The D 
indicates that it is a directory, and the L 
indicates that it has been locked and so may 
not be deleted or over-written. 


$ 

Disc 11 24 Mon :0 

Option 00 (Off) 

URD "Unset" 

Dir. "Unset" 

Lib. "Unset" 

Progl WR 

TESTDIREC DL 


Figuře 2. Catalogue display 


If we wish to select this new directory we 
can use the command: 

*DIR TESTDIREC 

This makes TESTDIREC the currently 
selected directory. If you now perform a 

*CAT 

you can see the contents of this new directory, 
which of course should be empty. If you savé a 
program now, it will be saved into the 
TESTDIREC directory because that is the 
currently selected directory. You can get back 
to the root directory by simply typing: 

*DIR $ 

Once you are back in the root directory, 
and you wish to savé or load a program in the 
TESTDIR directory, you can either do it by re- 
selecting that directory (using *DIR TESTDIR) 
or by loading (or saving) directly, specifying the 
full path to that directory, thus: 

LOAD "$.TESTDIR.progname" 
Notě the use of the full stops to separate the 
directory names. 

As you may háve realised, the new 
directory TESTDIR which we created, actually 
resides within the old root directory; and you 
may begin to see the reason for calling it a root 
directory. All other items stem from the root 
directory. If you create new directories, they will 
be within the root directory, or indeed within 
other directories, which are themselves within 
the root directory. This is called a hierarchical 
directory structure. 

Figuře 3 shows the contents of an ADFS 
disc, arranged so that you can see the so- 
called tree structure more clearly. From this 
you can see that the root directory contains just 
two objects, a filé called Progl and a directory 
called MAINPROGS. The directory 
MAINPROGS itself contains two sub- 
directories (UTILITIES and APPS), and three 
files. For clarity, directories háve been created 
using upper čase text, and you may like to 
follow this convention. Directories can in fact be 
nested down to 127 levels, and each directory, 
except the last, could contain 77 further 
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directories, so you can see that an ADFS disc 
can háve a very complex structure. In practice 
it is a good idea not to nést your directories too 
deeply, because it makes moving around within 
the directory structure quite laborious. 


$ 


Progl MAINPROGS 


Gamel Game2 Menu UTILITIES APPS 


Figuře 3. ADFS directory hierarchy. 

SHORT CUTS 

There are also other ways to make life a 
little easier. The first is to use the disc menu 
listed elsewhere in this issue. Once this is 
installed in your machine, you need only type: 

*MENU 

and then use the mouše to move around within 
the directory structure of your disc. You can run 
program files directly from the menu, as 
described in the article, or if you exit from the 
menu, you will find that you are left in the 
directory which you last selected. 


USING DISCS 



To automate the process somewhat, why 
not create a IBOOT tile to call the keys 
program every time that you press Shift-Break 
(i.e. hold down the Shift key, and at the same 
time tap the Break key)? A suitable IBOOT filé 
can be generated as follows. First selecí the 
root directory of your disc (use ‘DIR $), then 
type: 

*BUILD IBOOT 

At the prompt, type: 

CHAIN "$.Keys" 

Then press Return, then Escape. If you now 
type: 

*OPT 4,3 

this will telí the Computer to execute the IBOOT 
filé as a command filé whenever you perform a 
Shift-Break. If you now press Shift-Break, it 
should all happen, assuming of course that the 
Basic program containing your key definitions 
is called "Keys", and resides in the root 
directory. 


10 REM FUNCTION KEY DEFINITIONS 
20 *KEY1 *MOUNT|M*CAT|M 
30 *KEY2 *CAT|M 

40 *KEY3 *DIR $.PROGRAMS|M*CAT|M 
50 *KEY4 *DIR $.GRAPHICS|M*CAT|M 
60 etc 


Figuře 4 

Example function key definitions 


Another triek is to use the function keys to 
také you to your most commonly ušed 
directories. See figuře 4 to give an idea of how 
this is doně. (The bar character | is on the key 
immediately above the Return key.) You will 
see that these key definitions are arranged in a 
simple Basic program, and that keys 1 and 2 
are ušed to MOUNT and CATalogue a disc 
respectively. The command * *MOUNT is 
normally ušed to telí the ADFS that a new disc 
has been inserted, but it can also be ušed to 
get you back to the root directory of your 
current disc. The definitions of keys 3 and 4 are 
terminated with a *CAT command, so that as 
well as selecting a given directory, its contents 
are automatically displayed. Just CHAIN the 
program to set up the keys. 


There will be more on using dises next 
month. In the mean time, if you háve any 
queries, problems or tips, please drop us a 
line. Q|] 

SAFE FILÉ DELETION HINT 

You can use *SET ALIAS to create the new 
command ‘DEL to give you a wildearded filé 
delete facility without the danger of wiping all 
files if you forget to add the C parameter 
required with ‘WIPE. Use 

*SET ALIAS$DEL WIPE %0* C %1 %2 %3 
Now if you execute ‘DEL Prog the effect will be 
the same as executing ‘WIPE Prog‘ C. And 
‘DEL with no filename will offer all items in the 
current directory for possible deletion. l.g.c 
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The Archimedes boasts many powerful graphics features, and can be 
ušed to generate quite stunning visual effects from very smáli amounts of 
code. We shall be using these columns in the coming months to give 
some idea oř the machine s potential. This month s contribution is most 
appropriately from Paul Fellows at Acom. 


RANDOM SPHERES 

The program Spheres uses a simple 
technique to create randomly coloured spheres 
and to distribute them randomly about the 
screen. The picture below gives little idea of the 
colourful effect created, and no idea of the 
relative speed with which the spheres are 
generated. 

There are a number of tricks ušed in the 
program, but nothing too esoteric. The most 
important part is the generation of the spheres 
themselves. This is carried out in the proceduře 
PROCsphere, which creates a single coloured 
sphere each time it is called. The spheres 
actually consist of a set of eight filled circles of 
progressively increasing lightness of shade and 
decreasing size. This is handled in the FOR- 
NEXT loop at line 230. To add to the 3 
dimensional effect, the centre of each sphere is 
progressively offset upwards and to the right by 
a smáli amount (line 260). 



10 REM >Spheres5 

20 REM Program Random Spheres 
30 REM Version A 0.5 
40 REM Author Paul Fellows 
50 REM Risc User November 1987 


| A105 [ SC 20 | 5P - | RMA - | 

60 REM Copyright Acorn Computers Ltd 
70 : 

80 MODE15:OFF 
90 step%=8:radius%=64 
100 rad2%=radius%»l 
110 L%=LOG(512/radius%)/LOG2 
120 REPEAT 
130 VDU29,FNX;FNY; 

140 PROCsphere 
150 UNTIL FALŠE 
160 : 

170 DEFFNX=RND (640) «1 
180 DEFFNY=RND (256) «2 
190 DEFFNrgb=(RND(3)-1)*1+(RND(3)-1)*4 
+(RND(3)-1)*16 
200 : 

210 DEFPROCsphere 

220 Base%=FNrgb:GCOL Base% 

230 FORX%=radius% TO step% STEP-step% 
240 VDU23,17,2, 512-(X%«L%) | 

250 IFX%<=rad2% GC0LBase%+&15 

260 MOVE-X%DIV3,-X%DIV3:PLOT&9D,X%,0 

270 NEXT:ENDPROC 

The colour of the spheres is determined at 
three different lineš in the program. The base 
colour is selected randomly at line 220 by 
calling the function FNrgb. Line 240 cycles 
through 4 progressively lighter tints of the base 
colour, and the effect of this is doubled up (so 
producing 8 shades in total) by adding &15 to 
the base colour once the first 4 circles háve 
been drawn (line 250). 

LISSAJOU S SPHERES 

The second program listed here is based 
heavily on the first. It uses a slightly modified 
version of PROCsphere, and instead of placing 
the spheres randomly on the screen, they are 
made to follow a waveform made up of a 
randomly selected sin-cos combination. This 
results in the creation of a wide variety of 
interesting three dimensional images. To add to 
the visual effect, a randomly chosen back- 
ground colour is ušed with each new pattern. 
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10 REM >Lissajou4 

20 REM Program Lissajou's Spheres 
30 REM Version A 0.4 
40 REM Author Lee Calcraft 
50 REM Risc User November 1987 
60 REM Program Subject to Copyright 
70 : 

80 MODE15:OFF:VDU19,0,24,190,190,190 
90 REPEAT 



100 A=0:Q%=RND(60):R%=RND(10) 

110 S=RND(4):T=RND(2):U=RND(3) 

120 GCOL(RND(128)+128):CLG 
130 REPEAT 

140 A+=0.2:VDU29,FNX;FNY; 

150 PROCsphere 
160 UNTIL A>70 

170 TIME=0:REPEAT UNTIL TIME=200 
180 UNTIL FALŠE 
190 : 

200 DEFFNX=640+(Q%-A)*10*COS(T*A+S) 

210 DEFFNY=512+A*R%*SIN(A-U) 

220 DEFFNrgb=(RND(3)-1)*1+(RND(3)-1)*4 
+(RND(3)-1)*16 
230 : 

240 DEFPROCsphere 

250 Base%=FNrgb:GCOL Base% 

260 FORX%=64 TO 8 STEP -8 
270 VDU23,17,2,512-(X%«3) | 

280 IFX%=32 GCOL Base%+&15 

290 MOVE-X%DIV3,-X%DIV3:PLOT&9D,X%,0 

300 NEXT:ENDPROC 

ETERNAL BOUNCE 

The third listing is again based on the 
sphere drawing proceduře, though this time it 
has been adjusted to draw half size spheres. 
When the program is run you will see a single 
green sphere bouncing effortlessly around a 


bordered screen. The program repeatedly 
applies the very powerful graphics block move 
command to the smáli rectangle containing the 
sphere (more on this in the next issue). This is 
moved around the screen in such a way as to 
simulate the trajectory of a balí with a restitution 
coefficient of one. The WAIT statement in line 
180 ensures that the move is synchronised with 
the frame scan of the VDU, and ensures a very 
smooth gliding action. If you wish to change the 
speed of the balí, you can experiment with the 
values of F and G in line 100. 

10 REM >Bounce5 

20 REM Program Bouncing Sphere 
30 REM Version A 0.5 
40 REM Author Lee Calcraft 
50 REM Risc User November 1987 
60 REM Program Subject to Copyright 
70 : 

80 MODE15:OFF:VDU19,0,24,190,160,240 
90 GCOL 160:CLG:Base%=8:GCOL Base% 

100 X1=0:Y1=0:X=8:Y=800:F=8:G=-16 
110 VDU29,68;68;:PROCsphere 
120 VDU29,0;0;:MOVE 0,0:MOVE 110,110 
130 REPEAT 

140 IF X<8 OR X>1165 F=-F 
150 IF Y<16 OR Y>900 G=-G 
160 X+=F:Y+=G 

170 MOVE XI,Y1:MOVE Xl+110,Yl+110 
180 WAIT:PLOT 189,X,Y:X1=X:Y1=Y 
190 UNTIL FALŠE 
200 : 

210 DEFPROCsphere 

220 FORX%=32 TO 4 STEP-4 

230 VDU23,17,2, 512-(X%«4) | 

240 IF X%<=16 GCOL Base%+&15 

250 MOVE-X%DIV2,-X%DIV2:PLOT &9D,X%,0 

260 NEXT:ENDPROC 

M 


SEND US YOUR VISUALS 
We are running a competition for the best 
Archimedes visuals. Winners will receive a 
£20 retail token, and will háve their programs 
featured in these columns. So send us your 
contributions without delay! 

Send to: Archimedes Visuals, 

RISC USER, Dolphin Plače, 

Holywell Hill, 

St Albans, Herts, AL1 1EX 
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USII1G THE EDITOR RI1D THE EII1ULRTOR 

David Graham explains how to make use of these two useful items from 

the Welcome Disc. 


THE BASIC EDITOR 

The Welcome disc contains an excellent 
Basic Editor, described in some detail in the 
Basic User Guide. To get this up and running 
on your own disc, use the following proceduře: 

First create a directory tor the module on 
your own disc. We will use a directory called 
MODULES: 

*CDIR $.MODULES 
Next, make a copy of the module: 

*COPY :0.$.MODULES.ARMBE :0.$.MODU 
LES.ARMBE P 

Follow the machine's prompts (as summoned 
by the P parameter) to insert source and 
destination discs. It is assumed here that only a 
single drive is available tor copying. 

Now mount your own disc: 

*MOUNT 
and type: 

* $.MODULES.ARMBE 

If you get the message No room in RMA, type 
QUIT, and perform the load again. Then use 
*BASIC to get back to Basic. 305 users may 
also need to configure more RMA space - see 
Hints & Tips. 

Now whenever you wish to use the editor, 
just type: 

EDIT 

from within Basic, and any program resident in 
the machine will be loaded into the editor. And 
don’t forget to use the speciál keystrip supplied 
for the purpose. 

THE EMULÁTOR 

The Welcome disc also contains a so-called 
6502 Emulátor. This is a piece of software 
which will allow you to run all 'legally written' 
programs from previous versions of the BBC 
micro. The programs may be in Basic or even 
in 6502 machine code. For example, you may 


run disc-based versions of View directly on the 
Emulátor. 

To get the 6502 Emulátor up and running 
from your own disc, copy the filé called 
65ARTHUR from the $.MODULES directory of 
your Welcome disc, just as described above for 
the Editor: 

*COPY :0.$.MODULES.65ARTHUR :0.$. 
MODULES.65ARTHUR P 

To engage the Emulátor, just type: 

* $.MODULES.65ARTHUR 
You will now be in Basic VI. To verify this, type: 

HELP 
or QUIT 

You will get the response: 

Mistake 

since although Archimedes Basic recognises 
these keywords, Basic VI (that ušed in the 
Master and Compact) does not. You may now 
run any legal program from earlier versions of 
the BBC micro - even those using 6502 
assembler. But remember, any direct access to 
memory will probably crash the systém. 

If you háve a RAM based version of View, 
such as that supplied with the Compact, this 
will work directly on the Emulátor. To achieve 
this, type the following: 

*$.MODULES.65ARTHUR 
to get into the Emulátor. Then 

*RUN VIEW 8000 

This assumes that View is in your current 
directory. 


*$.MODULES.65ARTHUR 



6502 Emulátor 0.82 

(01 

Jun 1987) 

Acorn 6502 TOS 0.40 

(11 

Jun 1987) 

BASIC 




Loading the emulátor 
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AN ALIAS FOR ARTHUR 

by Lee Calcraft 


The many variants of the operating systém commands ‘SET and ‘SET ALIAS 
provide the user with massive power and flexibility in customising his 
Archimedes. Here are some brief notes based on our initial investigations. 


SET ALIAS 

At the simplest level, you can use this 
command to rename already existing command 
sequences. Forexample: 

*SET ALIAS$BEEB $.MODULES.65ARTHUR 

will set up the new command *BEEB. When 
this is called, Arthur will execute 
*$.MODULES.65ARTHUR. This will engage the 
6502 Emulátor (assuming that it resides in 
$.MODULES). To také another example: 

*SET ALIAS$TEXT DIR $.LETTERS.1987TEXT 
will create the new command *TEXT which will 
select directory 1987TEXT, a sub-directory of 
$.LETTERS. Commands may also be linked 
using |M as a separator. Thus: 

*SET ALIAS$M MOUNT | MCAT 

will mount a disc and catalogue the root 
directory every time the command *M is issued. 

ECHO 

By incorporating the keyword ECHO, the 
alias can echo words and even VDU codes to 
the screen. For example: 

*SET ALIAS$B0RDER ECHO |<19>|<0>|<24>| 
<0>|<240>|<2 4 0> 

will create the new command *BORDER which 
sets up a cyan screen border. Each time the 
stár command is issued, the operating systém 
echoes the string of VDU characters 
19,0,24,0,240,240. 

PARAMETERS 

Parameters may be passed across into the 
alias string. As a trivial example: 

*SET ALIAS$L0AD ECHO I won't load %0 
will print the response: 

I won't load filename 
every time that you try to execute: 

*L0AD filename 

The %0 indicates that the parameter given 
when the command is issued is to be 
incorporated at this point in the new command. 
You can in fact incorporate up to 9 parameters 
in any new command. Use %0 for the first, %1 
for the second, and so on. Alternatively, the 


sequence %*0 sends the rest of the command 
line as a single parameter. 

SETTING FILÉ TYPE 

Filé types may be changed with a further 
variant of the ‘SET command. For example: 

*SETTYPE filename FFE 

will set the specified filé to filé type &FFE. This 
is the filé type for command files, and will 
ensure that if you execute *filename, the filé will 
be EXECed in, and so will execute properly. 


Some Useful 

Filé Types 

&FFFPIain ASCII 

&FF9 Sprite 

&FFE Command 

&FF8 To run at &8000 

&FFD Data 

&FF7 BBC Font 

&FFB Basic 

&FF6 Fancy Font 

&FFA Reloc Module 

1 


RUN TYPE 

There is also a very handy command to set 
the course of action followed by the operating 
systém when any filé of a given type is called. 
For example: 

*SET ALIAS $ @RUNTYPE_FFD EXEC %*0 

telíš the operating systém to EXEC in any filé of 
type &FFD which is called using ‘filename. This 
now means that any data files, if called in this 
way, will be EXECed in, without the need to 
use the ‘SETTYPE command on every filé. 

RUN PATH 

You can also specify the directory paths 
which the operating systém should search 
through in its attempts to find a given filé. For 
example: 

*SET RUN$PATH ,%,$.M0DULES 

means that when you execute ‘filename, 
Arthur will first check in the current directory 
(the space before the first comma indicates 
current directory), then it will look in the library 
directory (the % indicates this), and finally it will 
look in $.MODULES. As you can appreciate, 
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AN ALIAS FOR ARTHUR 


this is a very useful command to set up, since it 
means, tor example, that you can keep all your 
relocatable modules in a separate directory 
(e.g. $.MODULES), but you can call any 
module with just: 

*modulename 

without having to bother about directories. Of 
course you only need to call these various SET 
commands at power up and after Ctrl-Break; 
and they could all be put into a IBOOT filé for 
automatic installation. 

ARTHURIAN VARIABLES 

We now move on to further subtleties of 
Arthur. Acorn are beginning to build up a 
language in which the user may dialogue with 
Arthur, and it looks as if they will be extending 
these ideas in future releases. On Arthur 0.2 
there are a number of Basic-like statements 
which can be ušed directly from the systém 
prompt. For example, if you get into Arthur, and 
then type: 

IF SYS$TIME LEFT 2>11 THEN ECHO Good 
Afternoon ELSE ECHO Good Morning 

The result, as you might guess is that Arthur 
will say "Good Morning" or "Good Afternoon" as 
appropriate. Amongst other things here, we 
háve made use of the "speciál" variable 
SYS$TIME. You may also like to experiment 
with SYS$DATE and SYS$YEAR. 


CLI$PROMPT is another speciál variable, 
and is ušed to define Arthur's prompt. It is 
currently a stár, but may be changed using 
*SET. Thus: 

*SET CLI$PR0MPT Arthur>* 

will give a prompt of: 

Arthur>* 

any time that you are in supervisor mode. 
Perhaps more interestingly, you can make the 
prompt into the current time. For this you need 
a variant of the *SET command which re- 
evaluates the assigned variable every time that 
it is called, thus: 

*SETMACR0 CLI$PROMPT <SYS$TIME> 

In fact these SYS$ and CLI$ variables are a 
speciál čase of a new breed of operating 
systém variable. Try for example: 

*SET Name FRED 

If you now type *ECHO Name, the result will be 
"Name", but if you use: 

*ECH0 <Name> 

you will get the desired result "Fred". 

This is all extremely powerful stuff - of 
which more later. In the mean time, I leave you 
with just one more command: 

*UNSET name 

It can také wild cards, and will delete previously 
set variables. Use *SF10W to display all 
settings. 



ARCHIMEDES DISC MENU (continued from page 9) 


2740 EQUS STRING$(80,CHR$32):EQUB31 
2750 EQUB3:EQUB5 

2760 EQUS STRING$(74,CHR$32):EQUB31 
2770 EQUB3:EQUB6 

2780 EQUS STRING$(74,CHR$32):EQUB31 
2790 EQUB0:EQUB0:EQUB11 
2800 EQUS STRING$(80,CHR$32) 

2810 EQUB31:EQUB3:EQUB0 
2820 EQUS"Archimedes Disc Menu 
** RISC USER **" 

2830 EQUB17:EQUB0:EQUB17:EQUB128+8 
2840 EQUB31:EQUB63:EQUB5 
2850 EQUS" QUIT ":EQUB31:EQUB3 
2860 EQUB5:EQUS" DIR A ":EQUB23 


2870 EQUB1:EQUD0:EQUD0:EQUS"$":ALIGN 
2880.buff 
2890 ]:NEXT 

2900 OSCLI("SAVÉ RMENU "+STR$~code+" "+ 
STR$~(buff+&1000)) 

2910 *SETTYPE RMENU FFA 
2920 *RMLOAD RMENU 
2930 END 
2940: 

2950 DEFPROCsetup 

2960 wr=256:by=6:wo=7:rd=4 

2970 cli=5:ws=l:wc=0:ms=&lC 

2980 gb=&C:rs=&E:os=&16:es=&2C 

2990 ENDPROC _ 

1 
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OFF THE SHELF 



Mike Williams and Lee Calcraft háve been looking at some of the first products available 

off the shelř for your Archimedes. 


DELTflBflSE 

minERVfl SYSTEmS, L29.95 inc VflT 

Deltabase from database specialists Minerva is 
a sophisticated form of card index, and derives from 
Minerva's earlier System Delta and Card Index for 
the old BBC Micro and later Master series. Within 
the card index formát Deltabase offers a wealth of 
facilities for entering, processing and extracting 
information in a card index filé. 

Over 8000 entries are possible in a single card 
index, with up to 255 fields per card. Card layouts 
are defined by the user and allow prompts, or other 
descriptive text, and entry fields to be laid out as 
required. You can also specify the order in which 
fields are to be entered, and fields may be linked 
together (for example the day, month and year). 

Once a filé and record formát háve been 
defined you can begin to enter data. At any time you 
may browse through the card records, search for 
particular entries (and if your knowledge of Basic is 
good, quite complex searches are possible), and 
display or print selected fields from each record. 
Card index files may be sorted using any 
combination of fields or part-fields to form a search 
key. Again, a knowledge of Basic will help in 
constructing complex sort keys which are evaluated 
using Basitfs EVAL function. 



In a short review it is impossible to cover all the 
facilities of a package such as Deltabase in detail. 



Suffice it to say that for a card index the facilities 
are very comprehensive. I do, however, háve two 
criticisms of Deltabase. The systém is very strongly 
menu driven using the keyboard to select any 
option, and many Control-key combinations are also 
ušed. This is disappointing on a machine which has 
a mouše and all the supporting WIMPS software as 
standard. From the screen appearance Deltabase 
might almost be running on an ordinary BBC model 
B. Secondly, I find the manual poorly laid out, and 
difficult to read. I believe the user of a package such 
as this requires a well written, clearly laid-out 
introductory and tutoriál section, followed by a 
concise and efficient reference to all the facilities. 
Minerva appears not to agree. 

Deltabase certainly provides a more than 
adequate package for many database requirements 
based on the card index approach, but do be 
prepared for some difficult reading in almost every 
sense if you are going to make the most of what 
Deltabase has to offer. 

ZARCH 

SUPERIOR SOFTWARE, L19.95 inc VflT 

Everyone buying an Archimedes gets a taste of 
Zarch in the form of Lander, and if past experience 
is anything to go by, that alone has even the most 
humble games player drooling at the mouth over 
the super fast and impressive graphics. Zarch (what 
an odd name) is the reál thing, and very good 
indeed it is too. 


RISC User November 1987 


27 




















OPP THE SHELP 


■ 


The scenario of this game does sound 
somewhat contrived, as you seek out and destroy 
the environment-polluting 'Seekers', but in the end it 
boils down to a typical shoot-the-aliens scene. What 
sets this game apart is the sheer speed of 
everything, from the scrolling multi-coloured 
landscape through to the desperately fought out 
aerial dogfights high in the sky. 



On-screen displays show your altitude and fuel 
level throughout the game, and a radar scan (in 
large or smáli scale) is an essential adjunct for 
locating the enemy (and your home base for 
refuelling and re-arming). Beware of shooting the 
rotating radar towers though, or you will find your 
radar display partly blacked out. 

Whether the game is worth the price asked for it 
you must judge for yourself, but if you've just bought 
an Archimedes, or are about to do so, then you 
might miss out on one of THE games of 1987. Buy 
now and enjoy the fun. M.c.w. 

Twin 

fíCOHnSOFT, £33.35 inc VAT 

Twin is a sophisticated multi-purpose text 
editor, and for those with experience of the BBC 
Master 128, it is very similar in operation to the 
Master Editor bundled with that machine. It differs 
from the Basic Editor supplied with the Archimedes 
in that it is not line number orientated. While the 
Basic Editor supplies line numbers, Twin offers a 
completely open formát, and when it is ušed to edit 
a Basic program, it treats it just like any ASCII filé. 
Having said that, ARM Basic recognises the 
keyword TWIN (try also TWINO 8), and in 


response, will cause Twin to be loaded from disc 
with any resident Basic program suitably 
detokenised, and installed in Twin's text buffer 

Twin is much more flexible than the ARM Basic 
Editor, and you can use it to examine and edit data 
files of all kinds. It is particularly useful for creating 
and editing command files including IBOOT files, 
which is not possible with the Basic Editor. It also 
has a much more sophisticated search and replace 
facility. 

Finally.Twin boasts a powerful duál window 
mode from which, in fact, its name is derived. Using 
this facility, any two files may be concurrently 
displayed and edited. Data may be transferred 
between the Windows, and there is even a measure 
of multi-tasking built in. You may for example 
compile and run the source code of a language 
such as C, while simultaneously using the other 
window to edit an object filé. 

TQOLKIT 

CLARES, £39.95 inc VAT 

Clares Micro Supplies háve developed a Toolkit 
for the Archimedes, and although not completely 
finished at the time of writing, it is due for release 
within a few days. Toolkit performs a number of 
useful disc and memory based activities. Many of 
these make use of an extremely fast full screen 
editor. In disc mode, this allows you to read and edit 
any byte on a disc, while in memory mode you can 
display and edit any byte of RAM. The editor can 
operáte in a number of different formats including 
ARM instruction formát, and Clares háve even 
included a line by line assembly facility, allowing 
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you to enter ARM assembler instructions directly at 
the keyboard. To assist the machine code 
programmer there are also a number of search 
operations, a block compare, and a memory move 
routine 


you are ušed to Wordwise, and wish to bridge the 
gap before a dedicated Archimedes word processor 
becomes available, the product (as an upgrade) is 
very reasonably priced at £11.50. 


Generally speaking this product is for the 
advanced user, though there are one or two useful 
options which will appeal to all, such as *CATALL 
which will catalogue a whole disc, and *DIRALL 
which will list all the directories on a disc 


GENERAL: 


*BIT 

*ENVIRONMENT 

*HCOMPARE 

*HEX 

*HFIND 

*MEDIT 

*MFIND 

*MNEMONIC 

*SHIFT 

*SWAP 

*TEXT 

*TFIND 

*WCOMPARE 

*WFIND 

*WORD 


ADFS: 


*AEDIT 

*AHFIND 

*AMFIND 

*ATFIND 

*AWFIND 

*CATALL 

*DIRALL 

*EXALL 



Toolkit Commands 


flCQRIlSOFT C, PASCAL AI1D FORTRAN 

LI 13.85 ERCH inc VRT 

Acornsofťs C is a full implementation of the 
draft ANSI standard, and is currently available in 
what Acorn call a pre-production package. Unlike 
their BBC micro C, recently released, this version 
does produce fully stand-alone code. When the full 
release is available, users may upgrade free of 
charge, but at present the documentation is very 
brief - just 55 pages, so you would be advised to 
wait until the full package becomes available unless 
you are already familiar with the C language. 

Acornsoft Pascal and Fortran are also available 
off the shelf for the Archimedes. Again these are in 
a pre-production form, with free upgrades when the 
finál versions become available. 

WORDWISE PLUS 

COinPUTER COnCEPTS, L33.35 inc VRT 

Wordwise Plus is now available on disc for the 
Archimedes. It runs under the Emulátor only, and is 
a little on the slow side. But it does the job, and if 


RRIT1 RSSEII1BLY LflllGUflGE, 

IT1TC , L12.95 inc VRT 

This very useful book written by Peter 
Cockerell, and available from the Computer 
Concepts stable has been on the shelves for a 
number of months now. Indeed it was available 
before the machine itself. It is very competently 
written, and extremely easy to follow. My only 
criticism is that it could contain more examples in 
the early stages of the book. But this book is really 
a must for anyone interested in ARM assembler. 


RRCHimEDES PROGRflmmER^ 
REFEREDCE mflílUAL, 

RCORn, L29.95 inc VRT 

This important two-part tome should be 
available by the time you read these words. It offers 
quite extensive documentation on the machine, and 
will prove invaluable to anyone who has moved out 
of the beginner's league. Unfortunately there is a 
large gap between the level covered in this guide, 
and that of the User Guide. The Programmer's 
Manual is crammed with information, but much of it 
is too briefly expressed for those new to the 
machine. Obviously, with a machine as complex as 
the Archimedes, more documentation is badly 
needed, especially works which can bridge the gap 
between the technical subtleties of the 
Programmer's Reference Manual and the Basic 
User Guide. But Acorn háve doně well to get this 
product into the shops at this stage. L.G.C. 


Minerva Systems, 

69 sidwell St, Exeter, 
Devon EX4 6PH. 


Acorn Computers Ltd., 

Cambridge Technopark, 
645 Newmarket Rd, 
Cambridge CB5 8PD. 


Computer Concepts, 

Gaddesden Plače, 

Hemel Hempstead HP2 6EX. 


Cla 
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res Micro Supplies, 

Middlewich Road, 
dheath, Northwich, 
eshire CW9 7DA. 



Superior Software, 

Regent House, 

Skinner Lané, 

Leeds LS71AX. 
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In our first issue of RISC User, we bring you a speciál double page crop of hints and tips, 
supplied by Rob Barnes, Graham Stanley and Lee Calcraft. 


BACKING UP 

To make a backup copy of a disc, Acorn advise that you 
use the speciál program Newbackup found in the Library 
directory of your Welcome disc. With your Welcome disc 
in drive zero, type: 

* $.LIBRARY.Newbackup 
Then follow the prompts. 

*COPY OPTIONS 

Use ‘HELP COPY to find out about all the possible 
options for use with ‘COPY. Beware of the Q or Quick 
option, though. This sometimes caused our machines to 
hang. And remember that you must always give a 
destination filename when using ‘COPY (not necessary 
with the ADFS in earlier BBC micros). 

WIPE WARNING 

The excellent command ‘WIPE allows you to selectively 
delete files to clean up your discs. Use ‘HELP WIPE to 
find out the various options. But be warned that: 

*WIPE * 

will wipe all files from your current directory without any 
warnings! Worse still: 

*WIPE * FR 

will completely wipe the whole contents of a disc, 
scouring out even the deepest nested directories, and 
completely ignoring the locked status of any files. Again, 
no prompts are given. 

STAR SPACE 

When communicating with Arthur using stár commands 
which require parameters, it is essential to leave a space 
before the first parameter. For example, if you use: 

*MOUNTO 

instead of *mount o you will get a "Bad command" 
message. 

*HELP 
The commands: 

*HELP 

and *help topič 

give masses of useful information. To display all the 
machine's help messages, use: 

*HELP . 

The space before the full stop is essential. Don't forget to 
press Shift to scroll the display. You may find it worth 
printing this out by pressing Ctrl-B before issuing the Help 
command. 


SCROLL VARIANTS 

When using the LIST command to list a Basic program, 
the following may be useful: 

Press Ctrl and Shift to freeze 
Press Scroll-Lock to freeze/unfreeze 
Press Shift to slow the scroll 

Additionally using Ctrl-N before listing will page the 
display. Then use Shift to scroll, and Ctrl-0 to cancel the 
effect. 

LANDER HINT 

When playing the Welcome Lander game, the following 
may be useful: 

Scroll-Lock will pause the game 
Ctrl will slow it down 

PRINTER LEAD 

The Archimedes parallel printer socket is just like that 
ušed on the IBM PC. This means that a standard IBM 
printer lead can be ušed. But you may find that BBC 
stockists can supply this item more cheaply than business 
computing suppliers. 

STANDARD STAND 

You may not háve spotted that both the keyboard and 
monitor háve built-in stands which fold out from 
underneath. The keyboard stand tilts the keyboard to a 
very convenient angle. 

LIST IF 
The command 

LIST IF word 

should find all occurrences of the word word in your 
program. But it will not work properly unless you leave NO 
space between the IF and the word. So, for example, to 
find all procedures, use: 

LIST IFPROC 

QUITTING BASIC 

When loading modules of various kinds, you may háve 
received the message No room in RMA 
(RMA=Relocatable Module Area). You can often get 
around the problém by quitting Basic - use: 

QUIT 

Next, perform your module load. Then re-enter Basic by 
typing: 

BASIC 

As you will notice, Arthur provides the asterisk. 
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LIST VARIABLES & LIBRARIES 
The very useful command: 

LVAR 

will list all variables and arrays, including the resident 
integer variables. It also gives a list of all resident Basic 
libraries. 

BASIC HELP 
The command: 

HELP 

on its own (i.e. without the asterisk) gives useful Basic 
status information, including program length and the 
amount of free memory. Try also the extensive HELP 
facility in RAM Basic. 

SINGLE STEPPING 

Use: 

TRACE ON 

to display line numbers as a program runs. To single-step 
through the program, ignore the User Guide, and type: 

TRACE STEP ON 

Try it with the Spheres programs in this issue. Type RUN, 
then press the space bar to advance each step. 

BORDERING 

To generate coloured screen borders outside the normál 
graphics area, use: 

VDU19,0,24,r*16,g*16,b*16 

where r, g and b can také values from 0 to 15, specifying 
the red, green and blue components of the border. For 
example: 

VDU19,0,24,0,240,240 

gives a cyan border (max green and blue with no red). 

CURSOR ON/OFF 

There are two very simple commands to turn the screen 
cursor on and off. They are: 

ON 

and off 

which should be pretty easy to remember! 

AUTO-SAVE 

If you include a REM line as the first line of your program 
in the following way: 

10 REM >filename 
every time that you type: 

SAVÉ 

giving no filename, Basic will savé your program using the 
name given in the REM statement. To make the operation 
even slicker, try programming a function key to do the 
work for you: 


*KEY0 SAVÉ|M 

will cause a savé to be made every time that the Print key 
(which doubles as function key zero) is pressed. 

INVERSE VIDEO 
The command: 

VDU23,17,5| 

will reverse the video output. This gives black text on a 
white background, which can be much easier to read than 
white on black. To return things to normál, either issue the 
command again, or execute a mode change. 

PROGRAM END 
Use: 

PRINT END 

to give the end of a program in memory, taking variable 
storage into account. 

COMMAND FILÉ TYPING 
If you create a command filé using ‘BUILD, or a word 
processor such as View, Wordwise or the text editor Twin, 
you will find that although you can use: 

*EXEC 

to call it, you cannot just give its name to the operating 
systém to EXEC it in. You will get the error message 
Code runs too low. To make Arthur realise that it is a 
command filé, you need to change the file's filé type. You 
achieve this as follows: 

*SETTYPE filename FFE 
where filename is the name of the command filé. The 
letters FFE represent the hex filé type for a command filé. 

CONFIGURING 305 SYSTEMS 
It is often possible to reconfigure Archimedes 305 
machines to run programs which would normally require a 
310. For example, to configure a 305 to cope with screen 
mode 15 (and avoid the Bad mode error), use: 

*CON. SCREENSIZE 20 
Then use Ctrl-Break (press the Ctrl key and the Break key 
simultaneously). Use *CON. SCREENSIZE 0 to set it 
back again. 

Alternatively, if you get the message No room in RMA 
then try reconfiguring the RMA size with: 

*CON. RMASIZE n 

If n=1 this reserves 8K, n=2 gives 16K, and so on. 
Obviously you should reserve no more than needed by a 
particular application when using a 305. And again, as 
with all ‘CONFIGURE options, you must press Ctrl-Break 
before it takés effect. To give an example, you need to set 
n=15 to run the 6502 Emulátor or the Basic Editor. 1711 
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RISC User ís available only on subscríption, with a speciál introductory rotě untíl eariy 1988. 
Fuli subscríbers to RISC User may also také out a reduced rate subscríption to BEEBUG (the 
magazine for the BBC micro and 
Master serles). 

AU subscriptions, including 
overseas, should be in pounds 
sterling. We will also accept 
payment by Connect, Access 
and Visa, and official UK orders 
are welcome. 


Subscríption Rates (12 Months) 

RISC User BEEBUG 

(reduced rates) 

UK, BFPO, Ch.ls 

£12.50 

£ 8.00 

Rest of Europe &Eire 

£18.00 

£10.00 

Middle East 

£22.50 

£11.00 

Americas & Africa 

£25.00 

£11.50 

Elsewhere 

£27.00 

£12.00 


BACK ISSUES 

We íntend to maintain stocks of back issues as they become available. New subscríbers 
can therefore obtaín earííer copíes to provide a complete set from Vol. 1 Issue 1. Back 
isues cost £120 each. You should also include postage as shown: 

Destlnatlon UK, BFPO, Ch.lt Europe plut Elre Elsewhere 

First Issue 40p 75p £2 

Each subsequent Issue 20p 45p 85p 
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magazíne disc 


It Is our intention to publísh each month all the programs from that Issue of RISC User on 
3.5" disc. This will be available to order, or you may také out a subscríption to ensure that 
the disc arríves at the same time as the magazine. The flrst issue of RISC User contains six 
programs and these are availble at the speciál lowprice of £3.75. 

Disc subscriptions Include 
postage, but you should add 
50p per disc for indívidual 
orders. 

All orders, subscriptions and 
other correspondence should 
be addressed to: 


The prices for future issues are shown below: 


UK 

Overseas 

Single Issue discs 

£ 4.75 

£ 4.75 

Six months subscríption 

£25.50 

£30.00 

Twelve months subscríption 

£50.00 

£56.00 


RISC User, Dolphin Plače, Holywell Hill, St Albans, Herts AL1 1EX. 
Telephone: St Albans (0727)40303 

(24hrs answerphone Service for payment by Connect, Access or Visa card) 
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PROGRAMMING IN C' 

An introductory senes of articles (at least four) on the programming language 'C' is planned for 
publication in RISC Users sister magazíne BEEBUG, starting with Vol.6 No.9 (March 1988) - see 
also this months editorial. By its nátuře, 'C is a machine independent language, and the articles are 
equally applicable to Archimedes Users. We háve therefore made arrangements to supply copies of 
the ’C articles to RISC User members at an all-in charge of £1.50. Just complete and retům the form 
below with your payment. 

Notě: BEEBUG is normally published approximately two weeks after RISC User, and copies of the 
'C' articles will be distributed with the following issue of RISC User. For those who purchase the 
RISC User magazíne disc, each 'C' article will also be included as a text filé for display or printing. 

RISC USER MAGAZÍNE DISC 

This months RISC User magazíne disc contains all the programs from Vol.l Issue 4. In addition, 
the disc also includes an implementation of part of the music from Peer Gynt Suitě No. 1 by Greig 
for use with the Welcome Music Editor, and a copy of the relocatable module produced by Acom 
as a fix for the Archimedes seriál port bug. This makes the disc tremendous value at just £5.25 
(£5.75 overseas) inc. p&p (magazíne discs for previous issues of RISC User are available at the same 
rate). Altematively také out a subscription for six months at £25.50 (£30.00 overseas), oř for 12 
months at £50.00 (£56.00 overseas). Complete the form below with your requirements and retům 
with your payment. 


To RISC User, Dolphin Plače, Holywell Hill, St Albans, Herts AL1 1EX. 

Please supply: 

□ £ . 

1 □ 2 □ 3 D 4 □ £. 

6 months O 12 months □ £. 

Starting with Issue:. 

(you may backdate) 


Programming in 'C 
Magazíne Disc Issue 
Disc Subscription 


Total £... 


Name 
Address . 


. Post Code. 

Membership Number. 

I enclose a cheque for £.(payable to BEEBUG Ltd) 

OR, I wish to pay by Access/Visa/Connect: Signed. 

Card No._/_/_/_/ Expiry Dáte _ 
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J 

































RISC USER INDEX TO VOLUME 1 


Classified under the followlng headings: 

GENERAL POSTBAG 

REVIEWS NEWS 

HINTS and TIPS 


GENERAL 


3D Cones and Cylinders 

Issue 

9 

Page 

24 

Editor and Emulátor 

Issue 

1 
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24 

3D Graphics Part 1 

5 

8 

Error of its Ways Part 1 

8 

11 

3D Graphics Part 2 

6 

7 

Error of its Ways Part 2 

9 

14 

3D Graphics Part 3 

7 

28 

Eternal Bounce 

1 

23 

3D Landscape Editor 

9 

5 

Fast Directory Copier 

6 

5 

ADFS Filé Find Utility 

9 

27 

Fast Image Rescaler 

9 

15 

Alias Font Scroller 

7 

5 

Fast Module Utility 

9 

39 

Alias for Arthur 

1 

25 

Fractal Pattern Generátor 

5 

18 

All The Colours of the Rainbow 

2 

24 

Full Screen Pixel Editor 

4 

14 

All-Mode Screen Compressor 

5 

28 

Generalised Plinth Proceduře 

7 

21 

Animating Archie Part 1 

8 

8 

Getting the Archimedes on Line 

4 

23 

Animating Archie Part 2 

9 

11 

Graphics 3D Part 1 

5 

8 

Animating Archie Part 3 

10 

21 

Graphics 3D Part 2 

6 

7 

Anti-Alias Fonts for Humans 

3 

12 

Graphics 3D Part 3 

7 

28 

Archie Plays Bach 

2 

6 

Hearsay Review 

9 

21 

Archie’s White Mouše 

1 

10 

Image Rescaler (Fast) 

9 

15 

Archimedes into PC 

2 

27 

Impulse Revealed 

8 

7 

Archimedes Screen Super-Saver 

3 

9 

Intelligent Auto-Configure 

6 

13 

Archimedes Series One Upgrade 

2 

5 

Introducing ARM Assembler Part 1 

5 

25 

Archimedes Speed Warning 

5 

10 

Introducing ARM Assembler Part 2 

6 

25 

ARM Assembler Part 1 

5 

25 

Introducing ARM Assembler Part 3 

7 

22 

ARM Assembler Part 2 

6 

25 

Introducing ARM Assembler Part 4 

8 

32 

ARM Assembler Part 3 

7 

22 

Introducing ARM Assembler Part 5 

9 

31 

ARM Assembler Part 4 

8 

32 

Introducing ARM Assembler Part 6 

10 

37 

ARM Assembler Part 5 

9 

31 

Landscape Editor 3D 

9 

5 

ARM Assembler Part 6 

10 

37 

Lissajoďs Spheres 

1 

22 

Array Parameters 

7 

19 

Logical RAM Tracer 

4 

19 

Arrays and Matrices 

3 

15 

Mega Worm 

6 

19 

At the End of the Rainbow 

4 

24 

Memory Editor 

3 

18 

Bach Played on the Archimedes 

2 

6 

Memory Map For Archie 

3 

28 

Basic Error Handling Part 1 

8 

11 

Module for Twin 

6 

33 

Basic Error Handling Part 2 

9 

14 

Module Utility (Fast) 

9 

39 

Basic Libraries 

2 

29 

Mouše - Using the 

1 

10 

Basic V - A Čase of 

5 

32 

Mouše Controlled Cursor 

10 

27 

BBC To Archimedes Transfer 

2 

31 

Mouše Driven Coloured Discs 

4 

11 

Beach Balí 

10 

29 

Mouše Driven Life 

10 

28 

Beat Box 

7 

8 

Mouše Pointer Designér 

4 

29 

Blue Bars 

3 

30 

Multi-Tone Printer Dump 

2 

8 

Bounce - Visual 

1 

23 

Music Maestro 

9 

7 

Čase Of Basic V 

5 

32 

News from the PC Show 

10 

25 

CMOS RAM Manager 

2 

13 

Over the Rainbow 

3 

22 

Cones and Cylinders 3D 

9 

24 

Palette Change Effeds 

4 

10 

Configuring Archimedes 

2 

13 

Pattern Generátor 

4 

10 

Directory Copier (Fast) 

6 

5 

PC Emulation 

2 

27 

Disc Menu Part 1 

1 

7 

PC Emulátor Part 1 

8 

21 

Disc Menu Part 2 

2 

18 

PC Emulátor Part 2 

9 

22 

Disc Menu Part 3 

3 

21 

PC Show News 

10 

25 

Discs - Using Discs 

1 

19 

Pixel Based 3D Spheres 

8 

22 

Duál Screen Cross-Fader 

7 

20 

Pixel Editor Update 

8 

18 

Dynam ic Boxing 

10 

32 

Play Along with Minerva 

8 

4 






Plinth Eftect 

3 

17 

Sound and Music 

1 

17 

Pointer Definer 

10 

13 

Speed Warning on Archimedes 

5 

10 

Printer Buffer tor the Archimedes 

3 

6 

Speeding up Basic 

10 

34 

Quad-Sized Shadowed Text 

3 

16 

Spraycan 

9 

24 

Rainbow Eftect 

3 

22 

Sprite Grabber and Painter 

10 

33 

Rainbow Squares 

2 

26 

Subtly Shaded Cylinders 

2 

16 

Random Spheres 

1 

22 

Supercharge the RISC User ADFS Menu 

10 

9 

Reading from the ADFS 

8 

26 

Textures from Paintbox 

2 

17 

Real-Time Image Spinner 

10 

6 

Toolbox Part 1 

7 

12 

Return to Sender 

6 

12 

Toolbox Part 2 

8 

14 

Screen Compressor - All Mode 

5 

28 

Toolbox Pari 3 

9 

35 

Screen Freezer and Dumper 

8 

30 

Toolbox Pari 4 

10 

31 

Screen Freezer and Dumper Update 

9 

42 

Transfer BBC To Archimedes 

2 

31 

Screen Manager 

5 

11 

VDU Planning Sheet Generátor 

6 

30 

Screen Manager Update 

6 

22 

Voice Generátor 

4 

5 

Screen Super-Saver 

3 

9 

Window on the Archimedes Part 1 

5 

5 

Series One Archimedes Upgrade 

2 

5 

Window on the Archimedes Part 2 

6 

21 

Series One Upgrade tor Archimedes 

2 

5 

Window on the Archimedes Part 3 

7 

15 

Shining ARC Display 

6 

18 

Writing a Relocatable Module 

4 

20 

Smart Screen Clearing 

8 

23 





REVIEWS 


1 st Word Plus from Acorn 

4 

12 

Disc Conversion Kit from Brainsoft 

3 

25 

3D Graphics Devetopment System 

7 

34 

Disc Drive (5.25") Interface - BEEBUG 

5 

30 

Acorn’s 1 st Word Plus 

4 

12 

Dread Dragon Droom from Resource 

6 

29 

Acorn's ArcWriter 

3 

5 

Euclid from Ace Computing 

8 

17 

Acorn's Kermit 

10 

43 

Flying Start from Mitře Software Ltd 

5 

16 

Acorn's Logistix 

3 

10 

GammaPlot from Minerva 

9 

28 

Acorn's MIDI Module 

5 

24 

Genlock Podule from G2 

6 

23 

Acorn’s Welcome Paint 

1 

14 

Hearsay from BEEBUG 

9 

21 

Acornsoft Ansi C 

2 

11 

l/O Podule from Acorn 

4 

31 

Acornsoft Twin 

1 

28 

Image Writer from Clares 

2 

22 

Alphabase from Clares 

6 

11 

Integrex Cotourjet 132 Printer 

8 

24 

Ansi C from Acornsoft 

2 

11 

Kermit from Acorn 

10 

43 

Archimedes 440 

4 

8 

Logistix from Acorn 

3 

10 

Architext from Hopesoft 

6 

17 

MIDI Module from Acorn 

5 

24 

ARCterm Professional from Seriál Port 

9 

40 

Minerva - GammaPlot 

9 

28 

ArcWriter from Acorn 

3 

5 

Minerva - SigmaSheet 

7 

10 

ARM Assembly Language Book from MTC 

1 

29 

Minerva - System Delta Plus 

3 

26 

Armadillo Sound Sampler Podule 

5 

21 

Minerva Systems Deltabase 

1 

27 

Artisan from Clares 

1 

14 

Newsmaster from LTS Publications 

9 

18 

Artisan Support Disc 

6 

24 

Pipedream from Colton Software 

8 

13 

Assembly (ARM) Language Book from MTC 

1 

29 

Printer Sharer from Technomatic 

5 

22 

Assembly Language Book from Dabs Press 

8 

28 

Programmers Reference Manual 

1 

29 

AutoSketch from Autodesk Ltd 

10 

18 

Resource - Desk Top Stories 

7 

33 

BBC to ARM Utilities from Resource 

5 

23 

Resource - Dread Dragon Droom 

6 

29 

BEEBUG's 5.25 Inch Disc Drive Interface 

5 

30 

ROM Podule from Computer Concepts 

3 

31 

BEEBUG's Hearsay 

9 

21 

Seriál Link from BEEBU 

3 

25 

BEEBUG's Seriál Link 

3 

25 

SigmaSheet from Minerva 

7 

10 

Brainsoft Disc Conversion Kit 

3 

25 

Soundsynth from Electromusic Research 

7 

25 

Clares Alphabase 

6 

11 

System Delta Plus from Minerva 

3 

26 

Clares Artisan 

1 

14 

Technomatic Printer Sharer 

5 

22 

Clares Image Writer 

2 

22 

Toolkit from Clares 

1 

28 

Clares Toolkit 

1 

28 

Twin from Acornsoft 

1 

28 

Colton Software - Pipedream 

8 

13 

U-Connect from Magenta Research 

10 

40 

Computer Concepts - Wordwise Plus 

1 

29 

Video Digitiser from Watford 

7 

26 

Computer Concepts ROM Podule 

3 

31 

Video Genlock Podule from G2 

6 

23 

Dabs Press - ARM Assembly Lang' Book 

8 

28 

Watforďs Video Digitiser 

7 

26 

Dabs Press - Assembly Language Book 

8 

28 

Welcome Paint from Acorn 

1 

14 

Deltabase from Minerva Systems 

1 

27 

Wordwise Plus from Computer Concepts 

1 

29 

Desk Top Stories from Resource 

7 

33 

Zarch from Superior Software 

1 

27 






HINTS & TIPS 


*COPY Options 

1 

30 

*COUNT tor Counting Disc Space 

3 

29 

•HELP 

1 

30 

305 Simulation 

5 

34 

305 System Configuration 

1 

31 

32-Bit Errors 

4 

34 

800K Formát for Speed 

4 

34 

ADFS Menu Whole Directory Copying 

5 

35 

Attered Run and Filé Paths 

3 

29 

Amplified Audio 

4 

34 

APPEND in Basic 

3 

29 

Auto-lnstall for Screen Manager 

8 

38 

Screen Manager Auto-lnstall 

8 

38 

Auto-Save 

1 

31 

Backup Automatically 

6 

35 

Automatic Backup 

6 

35 

Avoiding Program Loss 

7 

35 

Backing Up 

1 

30 

Basic APPEND 

3 

29 

Basic Debugging 

9 

46 

Basic HELP 

1 

31 

Beeb Style Break 

6 

34 

Booting from the DeskTop 

10 

46 

Booting the Disc Around 

9 

45 

Booting Without a Keyboard 

4 

35 

Bordering 

1 

31 

Bordering in Modes 3 and 6 

2 

30 

Brainsoft Disc Conversion 

6 

34 

Break as in BBC Micro 

6 

34 

Built-in Screen Dumps 

3 

29 

Calling Twin 

4 

35 

Changing the Palette 

6 

35 

Clearing the Mouše 

3 

29 

Colouring Twin 

2 

31 

Command Filé Typing 

1 

31 

Compacting 

5 

34 

Compacting Revisited 

8 

38 

Configuring 305 Systems 

1 

31 

COPY and WIPE in Full 

4 

34 

COPY and WIPE in Series One 

2 

30 

COPY Options 

1 

30 

COUNT for Counting Disc Space 

3 

29 

Cursor and VDU4 

7 

35 

Cursor on/off 

1 

31 

Debugger Breakpoints 

10 

46 

Debugging Basic 

9 

46 

Delete Key 

6 

34 

Desktop Function Key Retrieval 

3 

30 

Directories Last 

4 

34 

Directories Last - Again 

5 

35 

Disassembler Fix 

9 

45 

Disc Menu FileTypes 

9 

46 

Disc Menu on the NET 

7 

35 

Double Vision in Mode 7 

4 

34 

Easier OSWORD 

4 

34 

Econet Disc Menu 

7 

35 

Econet Fitting 

2 

30 

EXEC Filé Notes 

5 

34 

Fast Screen Saving 

2 

10 

Filé Moving 

10 

46 

Filé Types - More on 

2 

31 


Filetype Setting 

9 

45 

FileTypes in Disc Menu 

9 

46 

Finding Unplugged Modules 

3 

30 

Finding Your Plače 

7 

35 

Fitting Econet 

2 

30 

Flushed Mouše is a Happy Mouše 

2 

30 

Full Wipe, Full Copy 

4 

34 

HELP 

1 

30 

HELP in Basic 

1 

31 

Inverse Video 

1 

31 

Keyboardless Boot 

4 

35 

Label Based Restore 

7 

35 

Lander Hint 

1 

30 

LIST IF 

1 

30 

List Variables - Libraries 

1 

31 

LIŠTO 8 

2 

30 

Load and Savé Configuration Data 

5 

34 

Locating the Mouše 

10 

46 

Machine - Determining which 

2 

31 

MODE - Finding Current 

2 

31 

More Filé Types 

2 

31 

Mouše - Clearing 

3 

29 

Mouše - Location of 

10 

46 

Moving Files 

10 

46 

Named Discs 

8 

38 

Network Disc Menu 

7 

35 

Operating System - Determining 

3 

30 

OSBYTE Errors 

4 

34 

OSWORD Made Easier 

4 

34 

Part Screen Temporary Cache 

8 

38 

Pointer Trouble 

2 

30 

Printer Lead 

1 

30 

Program End 

1 

31 

Program Loss Avoidance 

7 

35 

Quitting Basic 

1 

30 

R-Key Configuring 

2 

30 

Resident Debug 

2 

31 

Restful Colours 

5 

35 

RESTORE Using Labels 

7 

35 

Returning MODE 

2 

31 

Safe Filé Deletion 

1 

21 

Savé and Load Configuration Data 

5 

34 

Screen Dumps Built-in 

3 

29 

Screen Parameters 

5 

34 

Screen Transfer 

7 

35 

Scroll Variants 

1 

30 

Series One WIPE and COPY 

2 

30 

Single Line Savé 

6 

35 

Single Stepping 

1 

31 

Smart Compacting 

5 

34 

Smart Compacting Revisited 

8 

38 

Some Useful Aliases 

5 

35 

Standard Stand 

1 

30 

Star Space 

1 

30 

SYS by Name or Number 

2 

30 

Twin - Calling of 

4 

35 

Twin Auto-Load 

3 

29 

Twin Hints 

9 

45 

Twin in Colour 

2 

31 

TWIN08 for Speed 

7 

35 

Typing Files - Filetype Setting 

9 

45 





VDU4 and the Cursor 

7 

35 

Which Operating System ? 

3 

30 

Viewstore Indexes 

*9 

46 

WIPE and COPY in Full 

4 

34 

Waiting for the Mouše 

10 

47 

WIPE and COPY in Series One 

2 

30 

Mouše - Waiting for 

10 

47 

WIPE Warning 

1 

30 

Which Machine ? 

2 

31 

Zarch Cheat Mode 

6 

34 


POSTBAG 


ARCwriter 

8 

37 

Members Ads 

8 

37 

Basic Bugs 

10 

45 

PC Emulátor and Arthur 

9 

44 

CrossFade Mods 

9 

44 

PC Emulátor Queries 

8 

37 

EXEC Errors 

10 

45 

Printer Drivers 

9 

44 

Faster Spheres 

10 

45 

Retrograde ROMS 

8 

37 
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0% Finance on Archimedes Purchases 

BEEBUG 

5 

4 

Ist Word Plus - Wordprocessor 

Acom 

4 

4 

Ist Word Plus - Wordprocessor 

Acom 

5 

4 

3D Solids Design Animation System 

Solicon Vision 

7 

4 

4 Megabyte Board 

Solidisk 

1 

6 

Acom Supply - Availability of 440 

Acom 

6 

4 

Alerion Invasion - Game 

Dabs Press 

9 

4 

Alphabase and Image Whter 

Clares 

1 

5 

Applications Catalogue - Podules 

Acom 

1 

4 

ARC-PCB - Circuit Board Design 

Silicon Vision 

10 

4 

Archeffect from FX Graphics Module 

Effects Galore 

9 

4 

Archimedes 300/305/310 

Prices Increase 

Acom 

7 

4 

Architype WYSIWYG Wordprocessor 

lan Copestake 

1 

6 

ArcTFS - Keep Track of your Text 

Texcellence 

9 

4 

Arcwriter 

Acom 

4 

4 

Arthur 2 from Acom OS 

Acom 

7 

4 

Artisan Proíessional 

Clares 

8 

4 

Artisan Utility Disc 

Clares 

3 

4 

Audio Sampler Podule 

Armadilk) 

1 

6 

BBC Micro Live Programme 

BBC 

3 

4 

Buffer your Data 

Clares Micro 
Supplies 

9 

4 

Chromalock - Genlock Podule 

WikJ Vision 

2 

4 

Communications Package 

Syncrotech 

2 

4 

Company Profits 

Acom 

7 

4 

Converting BBC Software 

Miscellany 

5 

4 

Designér CAD Package for Schools 

Techsoft 

1 

6 

Desk Top Stories 

Resource 

5 

4 

DeskTop Publishing Package 

DFS-ADFS Transfer Relocatable Module 

BEEBUG 

10 

4 

Diagram 

Pineapple 

Software 

4 

4 

Disc Drive Interface.- Extemal 

BEEBUG 

2 

4 

Droom 

Resource 

5 

4 

Finesse Paint - Art 

AMS 

1 

6 

Graphics Library 

Micro Studio 

5 

4 

Graphics Studio Graphics Library 

Micro Studio 

6 

4 

Hoverbod 

Minerva 

8 

4 

l/O Sound Sampler Podule 

Resources 

4 

4 

IFEL Four/4 Slot Backplane 

Podules and 
Backplane 

10 

4 

Impulse - New OS for Archimedes 

Computer 

Concepts 

7 

4 


Inter Series - Wordwise Plus 

Computer 

Concepts 

1 

4 

Languages Available 

Acom 

2 

4 

Laser Printer Driver Card 

Acom 

9 

4 

Logo 

Logotron Ltd 

4 

4 

Logo and Soft Sprites 

Logotron Ltd 

1 

5 

Matrix-3 

Cambridge 

Microsystem 

10 

4 

Micro-Trader - Micro-Stock 

Meadow 

Computers 

1 

6 

Missile Control 

Minerva 

8 

4 

Modem and Command ROM 

BEEBUG 

1 

4 

More Art for the Archimedes 

Fairhurst 

Instruments 

3 

4 

New Managing Director 

Acom 

3 

4 

NOAA Weather Satellite 

Unilab 

1 

6 

Off to a Flying Start 

Mitře Software 
Ltd 

8 

4 

Painting Competition - Winners of 

BEEBUG 

3 

4 

PC Emulátor - Version 1.20 

Acom 

6 

4 

PC Emulátor 1.09 

Acom 

4 

4 

Pipedream - WP/Spreadsheet/Database 

Colton Software 

6 

4 

Presenter - Business Graphics 

Lingenuity 

7 

4 

Printer Module 

CCD Computer 
Services 

4 

4 

RISC Chips Second Sourced from Sanyo 

Acom 

6 

4 

RISC User Paint Competition Winners 

BEEBUG 

3 

4 

ROM Podule 

Acom 

4 

4 

ROM/RAM Podule - Backplane 

Computer 

Concepts 

2 

4 

Shareware 

Contex 

Computing 

6 

4 

Sound Sampler 

Armadiilo 

Systems 

4 

4 

Spelling Checker for Pipedream 

Colton Software 

10 

4 

System Delta Plus 

Minerva Systems 1 

5 

Utility Program Suitě 

Resources 

4 

4 

Video Digitiser and Seriál Kit 

Watford 

Electronics 

1 

5 

View Series - View Proíessional 

Acomsoft 

1 

5 

Winchester Drive 

Watford 

Electronics 

10 

4 

Wordprocessor and Contract Bridge 

BBC Soft 

1 

5 








